搭建基于 Solon AI 的 Streamable MCP 服务并部署至阿里云百炼

一、快速搭建 Solon 项目，引入 Solon AI

1. 开发环境准备

• JDK 8 或以上版本。
  
• Maven 3.8.6 或以上版本。
  
• 通义千问 API Key（用于模型调用）。
  

2. 创建名为 mcp-server-demo 的项目

创建时选择 Archetype 为 Solon AI（可以减少些活），会自动添加 Solon AI、MCP 相关依赖。

创建后可以再简化下 pom.xml ：

1. <?xml version="1.0" encoding="UTF-8"?>
2. <project xmlns="http://maven.apache.org/POM/4.0.0"
3.          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
4.          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
5.     <modelVersion>4.0.0</modelVersion>
7.     <parent>
8.         <groupId>org.noear</groupId>
9.         solon-parent</artifactId>
10.         <version>3.5.1</version>
11.         <relativePath />
12.     </parent>
14.     <groupId>com.example</groupId>
15.     solon-bailian-mcp-workflow-server</artifactId>
16.     <version>1.0</version>
17.    
18.     <packaging>jar</packaging>
20.     <description>Demo project for Solon</description>
22.     <properties>
23.         <java.version>1.8</java.version>
24.     </properties>
26.     <dependencies>
27.         <dependency>
28.             <groupId>org.noear</groupId>
29.             solon-web</artifactId>
30.         </dependency>
31.         
32.         <dependency>
33.             <groupId>org.noear</groupId>
34.             solon-ai-mcp</artifactId>
35.         </dependency>
36.         
37.         <dependency>
38.             <groupId>org.noear</groupId>
39.             solon-logging-logback</artifactId>
40.         </dependency>
41.         
42.         <dependency>
43.             <groupId>org.projectlombok</groupId>
44.             lombok</artifactId>
45.             <scope>provided</scope>
46.         </dependency>
48.         <dependency>
49.             <groupId>org.noear</groupId>
50.             solon-test</artifactId>
51.             <scope>test</scope>
52.         </dependency>
53.     </dependencies>
55.     <build>
56.         <finalName>${project.artifactId}</finalName>
58.         <plugins>
59.             <plugin>
60.                 <groupId>org.noear</groupId>
61.                 solon-maven-plugin</artifactId>
62.             </plugin>
63.         </plugins>
64.     </build>
65. </project>

复制代码

二、添加 Mcp Server 并添加两个工具

使用 @McpServerEndpoint 注解，就像 MVC 开发一样简单。name 为 mcp-server-demo（可以按需设定），channel 使用 McpChannel.STREAMABLE（表示用 streamable 传输方式），mcpEndpoint 为 /mcp（可以按需设定）。
支持多个端点。就像 MVC 开发有多个控制器，每个控制器可以有自己的前缀地址。

1. import org.noear.solon.Utils;
2. import org.noear.solon.ai.annotation.ToolMapping;
3. import org.noear.solon.ai.chat.ChatModel;
4. import org.noear.solon.ai.chat.message.ChatMessage;
5. import org.noear.solon.ai.mcp.McpChannel;
6. import org.noear.solon.ai.mcp.server.annotation.McpServerEndpoint;
8. import java.util.List;
10. //工具，会再调用 dashscope 的模型。
11. @McpServerEndpoint(name = "mcp-server-demo", channel = McpChannel.STREAMABLE, mcpEndpoint = "/mcp")
12. public class McpToolServer {
13.     @ToolMapping(description = "批量生成标题")
14.     public List<String> BatchGenerateTitles(String title) {
15.         String SystemPrompt = "# 角色\n" +
16.                 "你是一位专业的批量生成标题助手，擅长根据用户提供的提示快速生成高质量的标题。\n" +
17.                 "\n" +
18.                 "## 技能\n" +
19.                 "### 技能1：理解用户需求\n" +
20.                 "- 仔细阅读并理解用户提供的提示和要求。\n" +
21.                 "- 根据用户的输入，确定标题的主题、风格和目标受众。\n" +
22.                 "\n" +
23.                 "### 技能2：创意标题生成\n" +
24.                 "- 能够在短时间内生成多个具有吸引力和多样性的标题。\n" +
25.                 "- 确保每个标题都符合用户的需求，并且能够吸引目标受众的注意力。\n" +
26.                 "\n" +
27.                 "### 技能3：标题优化\n" +
28.                 "- 对生成的标题进行优化，确保它们简洁明了、易于理解。\n" +
29.                 "- 考虑到SEO优化，合理嵌入关键词以提高标题的可发现性。\n" +
30.                 "\n" +
31.                 "### 技能4：多样化风格\n" +
32.                 "- 能够生成不同风格的标题，如新闻报道式、故事叙述式、疑问式等。\n" +
33.                 "- 根据不同的使用场景（如博客文章、社交媒体帖子、新闻报道等）调整标题的风格和长度。\n" +
34.                 "\n" +
35.                 "## 限制\n" +
36.                 "- 生成的标题数量为20个。\n" +
37.                 "- 每个标题应简洁明了，不超过20个字。\n" +
38.                 "- 所有标题必须与用户提供的提示和要求一致。\n" +
39.                 "- 避免使用过于复杂或难以理解的语言。\n" +
40.                 "- 如果需要特定领域的专业知识，可以通过调用搜索工具或查询知识库来获取相关信息。";
41.         String UserPrompt = "用户输入内容如下：" + title;
42.         String reTitle = null;
43.         try {
44.             reTitle = callWithMessage(SystemPrompt, UserPrompt);
45.         } catch (Exception e) {
46.             return Utils.asList("错误：" + e.getMessage());
47.         }
48.         if (reTitle == null) {
49.             return Utils.asList("错误：生成标题失败");
50.         }
51.         return Utils.asList(reTitle);
52.     }
54.     @ToolMapping(description = "文章润色")
55.     public List<String> polishTheArticle(String content) {
56.         String SystemPrompt = "# 角色\n" +
57.                 "你是一位专业的文章润色助手，擅长提升文章的语言表达、逻辑结构和整体流畅性。你的任务是根据用户提供的原始文本，进行细致的润色，使文章更加清晰、生动和有说服力。\n" +
58.                 "\n" +
59.                 "## 技能\n" +
60.                 "### 技能 1: 语言润色\n" +
61.                 "- 优化文章中的词汇选择，使其更加精准和生动。\n" +
62.                 "- 调整句子结构，使文章更加流畅自然。\n" +
63.                 "- 修正语法错误和拼写错误，确保文章的专业性和准确性。\n" +
64.                 "\n" +
65.                 "### 技能 2: 逻辑结构优化\n" +
66.                 "- 重新组织段落顺序，使文章的逻辑更加清晰。\n" +
67.                 "- 添加或删除内容，以增强文章的连贯性和一致性。\n" +
68.                 "- 提供适当的过渡句，使各部分之间的衔接更加自然。\n" +
69.                 "\n" +
70.                 "### 技能 3: 内容丰富与精简\n" +
71.                 "- 根据需要添加更多细节，使文章内容更加丰富和具体。\n" +
72.                 "- 删除冗余信息，使文章更加简洁明了。\n" +
73.                 "- 保持文章的主题和核心思想不变，同时提升其吸引力和可读性。\n" +
74.                 "\n" +
75.                 "### 技能 4: 风格调整\n" +
76.                 "- 根据用户的指示调整文章的风格，如正式、幽默、轻松等。\n" +
77.                 "- 确保文章的风格与目标受众相匹配。\n" +
78.                 "- 保持一致的语气和语调，增强文章的整体效果。\n" +
79.                 "\n" +
80.                 "## 限制\n" +
81.                 "- 只对用户提供的一篇文章进行润色，不涉及其他文档。\n" +
82.                 "- 润色过程中保持原文的核心内容和意图不变。\n" +
83.                 "- 不得添加或删除与文章主题无关的内容。\n" +
84.                 "- 如果用户提供了特定的风格要求，请严格遵循这些要求进行润色。\n" +
85.                 "- 在润色时，注意保留用户的个人风格和声音，避免过度修改。";
86.         String UserPrompt = "原始文本内容如下：" + content;
87.         String ReContent = null;
88.         try {
89.             ReContent = callWithMessage(SystemPrompt, UserPrompt);
90.         } catch (Exception e) {
91.             return Utils.asList("错误：" + e.getMessage());
92.         }
93.         if (ReContent == null) {
94.             return Utils.asList("错误：文章润色失败");
95.         }
96.         return Utils.asList(ReContent);
97.     }
99.     public String callWithMessage(String systemPrompt, String userPrompt) throws Exception {
100.         ChatModel chatModel = ChatModel.of("https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions")
101.                 .apiKey(System.getenv("DASHSCOPE_API_KEY"))
102.                 .model("qwen-plus")
103.                 .build();
105.         return chatModel.prompt(ChatMessage.ofSystem(systemPrompt), ChatMessage.ofUser(userPrompt))
106.                 .call()
107.                 .getContent();
108.     }
109. }

复制代码

提示：不需要别的配置或注册了。
三、添加测试类，简单试下效果

通过测试注解 @SolonTest(App.class) 启动服务端，通过 McpClientProvider 连接服务端并获取所有工具。

1. import com.example.mcp_server.App;
2. import lombok.extern.slf4j.Slf4j;
3. import org.junit.jupiter.api.Test;
4. import org.noear.solon.ai.chat.tool.FunctionTool;
5. import org.noear.solon.ai.mcp.McpChannel;
6. import org.noear.solon.ai.mcp.client.McpClientProvider;
7. import org.noear.solon.test.SolonTest;
9. import java.util.Collection;
11. @Slf4j
12. @SolonTest(App.class)
13. public class McpClientTest {
14.     @Test
15.     public void clientTest() {
16.         McpClientProvider clientProvider = McpClientProvider.builder()
17.                 .url("http://localhost:8080/mcp")
18.                 .channel(McpChannel.STREAMABLE)
19.                 .build();
21.         //获取所有工具
22.         Collection<FunctionTool> tools = clientProvider.getTools();
24.         log.error("{}", tools);
25.     }
26. }

复制代码

单测运行效果：

四、项目打包并部署

打包，并生成 mcp-server-demo.jar

发布到自己的服务器（可用 java -jar mcp-server-demo.jar 运行）。或者，上传到阿里云函数（界面太多，略过...）
五、将部署好的 Streamable MCP 集成到百炼当中

按照界面引导，添加配置（界面太多，略过...）。

后续，可以进一步创建智能体使用 Streamable MCP （界面太多，略过...）

来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！