Testmcpserver

🚀 テストMCPサーバー

このプロジェクトは、AnthropicのModel Context Protocol（MCP）プロトコルを使用して実装されたテストサーバーです。以下に詳細を紹介します。

✨ 主な機能

• 数学計算ツール：加法や乗法などの基本的な演算をサポートします。
• エラー処理：包括的なエラー捕捉とフィードバック機構を提供します。

📦 インストール

1. リポジトリをクローンする

   git clone <プロジェクトのURL>
   cd mcp-server-test
   

2. 依存関係をインストールする

   npm install
   

3. プロジェクトをビルドする

   npm run build
   

サーバーを起動する

node src/index.js

📚 プロジェクト構造

• src/controllers/MathsController.ts：数学演算の処理ロジックが含まれています。
• src/definitions/maths/addition.ts：加法ツールの定義ファイルです。

💻 使用例

基本的な使用法

ツール定義

// `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);
  }
});

📚 ドキュメント

Cursorへの統合方法

1. 設定を開きます。
2. 機能オプションに移動します。
3. MCPサーバーの部分までスクロールします。
4. 新しいMCPサーバーを追加するをクリックします。
5. サーバー名を入力します。
6. タイプをcommandに選択します。
7. サーバーアドレスを入力します。例えば、ローカルで使用する場合はnode <プロジェクトの絶対パス>/build/index.jsと入力します。

以上の手順を完了すると、サーバーの状態が緑色に表示され、登録されたすべてのツールが一覧表示されます。