MCP Server Template 🛠️

MCP サーバーテンプレート 🛠️

独自の Model Context Protocol（MCP）サーバーを構築するためのスターターテンプレートです。このテンプレートには、Cursor または Claude Desktop で使用できるカスタム MCP を作成するために必要な基本的な構成とセットアップが含まれています。

特長

• TypeScript を使用した基本的な MCP サーバーのセットアップ
• ツールの実装例
• すぐに使えるプロジェクト構成
• @modelcontextprotocol/sdk を使用して構築

プロジェクト構成

mcp-server-template/
├── index.ts        # Main server implementation
├── package.json    # Project dependencies
├── tsconfig.json   # TypeScript configuration
└── build/         # Compiled JavaScript output

はじめに

1. このテンプレートをクローンします。

git clone [your-repo-url] my-mcp-server
cd my-mcp-server

2. 依存関係をインストールします。

pnpm install

3. プロジェクトをビルドします。

pnpm run build

これにより、コンパイル済み MCP サーバースクリプトである /build/index.js ファイルが生成されます。

Cursor での使用

1. Cursor の Settings -> MCP -> Add new MCP server に移動します。
2. MCP を設定します。
   • 名前：任意の名前を選択します
   • 種類：command
   • コマンド：node ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js

Claude Desktop での使用

以下の MCP 設定を Claude Desktop の設定に追加します。

{
  "mcpServers": {
    "your-mcp-name": {
      "command": "node",
      "args": ["ABSOLUTE_PATH_TO_MCP_SERVER/build/index.js"]
    }
  }
}

開発

このテンプレートには、index.ts にツールの実装例が含まれています。独自の MCP を作成するには、以下の手順に従います。

1. index.ts のサーバー設定を変更します。

const server = new McpServer({
  name: "your-mcp-name",
  version: "0.0.1",
});

2. server.tool() メソッドを使って、独自のツールを定義します。

server.tool(
  "your-tool-name",
  "Your tool description",
  {
    // Define your tool's parameters using Zod schema
    parameter: z.string().describe("Parameter description"),
  },
  async ({ parameter }) => {
    // Implement your tool's logic here
    return {
      content: [
        {
          type: "text",
          text: "Your tool's response",
        },
      ],
    };
  }
);

3. 実装をビルドしてテストします。

npm run build

貢献

問題の報告や機能改善のリクエストをぜひお寄せください。

ライセンス

MIT