Cursor IDE Development Tools (Jira, GitHub, PostgreSQL)

🚀 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"
}

💻 テスト

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 エコシステムに統合できるはずです。