Testmcpserver

🚀 測試MCP 服務器

本項目是一個使用Anthropic的Model Context Protocol（MCP）協議實現的測試服務器，具備數學計算和錯誤處理等功能，能為用戶提供便捷的計算服務和穩定的錯誤反饋。

🚀 快速開始

本項目是一個使用Anthropic的Model Context Protocol（MCP）協議實現的測試服務器。你可以按照以下步驟啟動服務器：

node src/index.js

✨ 主要特性

• 數學計算工具：包含加法、乘法等基本運算，滿足常見的數學計算需求。
• 錯誤處理：提供全面的錯誤捕捉和反饋機制，確保程序運行的穩定性。

📦 安裝指南

克隆倉庫

git clone <項目地址>
cd mcp-server-test

安裝依賴

npm install

構建項目

npm run build

💻 使用示例

基礎用法

工具定義

// `src/definitions/maths/addition.ts`
export const ADDITION = {
  name: "addition",
  description: "計算兩個數字的和。",
  parameters: [
    { type: "number", name: "a", description: "第一個數字" },
    { type: "number", name: "b", description: "第二個數字" }
  ],
  example: "{ a: 2, b: 3 }"
};

控制器實現

// `src/controllers/MathsController.ts`
export class MathsController {
  async handleAddition(a: number, b: number) {
    try {
      const result = a + b;
      return {
        content: [
          { type: "text", text: `和為：${result}` }
        ],
        isError: false
      };
    } catch (error) {
      return {
        content: [
          { type: "text", text: `計算錯誤：${error instanceof Error ? error.message : String(error)}` }
        ],
        isError: true
      };
    }
  }
}

工具註冊

// `src/utils/toolRegistry.ts`
export const controllerMap = {
  addition: {
    controller: MathsController,
    handlerMethod: "handleAddition"
  }
};

高級用法

服務器配置

// `src/index.ts`
const tools = getToolDefinitions();

const server = new Server({
  name: "mcp-server",
  version: "0.1.0"
}, {
  capabilities: {
    tools: getToolDefinitions()
  }
});

server.setRequestHandler(ListToolsRequestSchema, async () => ({
  tools: tools
}));

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  try {
    const handler = getToolHandler(request.params.name);
    if (!handler) {
      return toolController.getUnknownToolResponse(request.params.name);
    }
    return await handler(request.params.arguments);
  } catch (error) {
    return toolController.getErrorResponse(error);
  }
});

📚 詳細文檔

項目結構

• src/controllers/MathsController.ts：包含數學運算的處理邏輯。
• src/definitions/maths/addition.ts：加法工具的定義文件。

集成到Cursor

1. 打開設置。
2. 進入功能選項。
3. 滾動至MCP服務器部分。
4. 點擊添加新MCP服務器。
5. 輸入服務器名稱。
6. 選擇類型為command。
7. 填寫服務器地址，例如本地使用時為node <項目絕對路徑>/build/index.js。

完成以上步驟後，服務器狀態將顯示為綠色，並列出所有已註冊的工具。