Cursor IDE Development Tools (Jira, GitHub, PostgreSQL)

🚀 MCP 服務器開發指南

本指南將詳細介紹如何開發和運行 MCP 服務器，幫助你快速將服務器集成到 MCP 生態系統中。

🚀 快速開始

要開始使用 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 生態系統中。