MCP 服务器开发指南

安装

要开始使用 MCP 服务器，请先安装所需的依赖：

npm install @modelcontextprotocol/sdk zod

运行 MCP 服务器

MCP 服务器可以通过以下命令启动：

npx ts-node src/servers/addition/addition.ts

创建新 MCP 服务器

要添加一个新的 MCP 服务器，请按照以下步骤操作：

1. 在 src/servers/ 目录下创建一个新目录：

   mkdir -p src/servers/my-new-server
   

2. 创建你的服务器实现代码：

   // src/servers/my-new-server/my-new-server.ts
   import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
   import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
   import { z } from "zod";
   
   const server = new McpServer({
     name: "My New Server",
     version: "1.0.0",
   });
   
   server.tool(
     "my-tool",
     {
       param1: z.string().describe("参数描述"),
       param2: z.number().describe("参数描述"),
     },
     async ({ param1, param2 }) => {
       return {
         content: [{ type: "text", text: `结果：${param1} ${param2}` }],
       };
     }
   );
   
   async function startServer() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
     console.log("我的新服务器已启动并准备处理请求");
   }
   
   if (process.argv[1] === new URL(import.meta.url).pathname) {
     startServer();
   }
   
   export default server;
   

3. 在 src/index.ts 和 src/run-all.ts 中添加你的服务器：

   const servers = [
     // 现有的服务器列表
     {
       name: "my-new-server",
       displayName: "我的新服务器",
       path: join(__dirname, "servers/my-new-server/my-new-server.ts"),
     },
   ];
   

4. 更新 package.json 中的脚本（可选）：

   "scripts": {
     // 现有的脚本
     "dev:my-new-server": "ts-node --esm src/servers/my-new-server/my-new-server.ts"
   }
   

测试你的 MCP 服务器

在连接到 Cursor IDE 之前，可以测试 MCP 服务器的功能：

1. 构建 TypeScript 项目：

   npm run build
   

2. 启动服务器：

   npm run start:addition
   

3. 在另一个终端中，可以通过手动发送 MCP 协议消息来测试服务器：

   {
     "type": "request",
     "id": "test1",
     "name": "add",
     "params": { "num1": 5, "num2": 7 }
   }
   

   服务器应返回：

   {
     "type": "response",
     "id": "test1",
     "content": [
       { "type": "text", "text": "5 和 7 的和是 12。" },
       {
         "type": "text",
         "text": "{\n  \"num1\": 5,\n  \"num2\": 7,\n  \"sum\": 12\n}"
       }
     ]
   }
   

4. 使用以下命令运行测试：

   npm test
   

注意事项

• MCP 协议：所有 MCP 服务器必须实现 MCP 协议的消息格式。
• 参数验证：工具参数必须通过 Zod 进行严格验证。
• 错误处理：确保服务器能够正确处理错误并返回适当的错误消息。
• 性能优化：对于高负载情况，建议进行性能调优。

完成以上步骤后，你的 MCP 服务器应该可以正常运行并集成到 MCP 生态系统中。