MCP Server Template 🚀

MCP サーバーテンプレート 🚀

Model Context Protocol (MCP) サーバーを構築するためのシンプルなテンプレートです。

MCP とは？

Model Context Protocol (MCP) は、Anthropic が開発したオープン標準です。Claude などの AI システムがさまざまなデータソースやツールとシームレスに連携できるようにし、安全な双方向接続を実現します。

このテンプレートは、Claude Desktop、Cursor、その他あらゆる MCP クライアントで使用できる独自の MCP サーバーを構築するための出発点となります。

テンプレートの機能

このテンプレートには次の内容が含まれています。

• MCP SDK を使用した基本的なサーバー構造
• コメント付きプレースホルダーを含むツール定義の例
• エラー処理の設定
• dotenv による環境変数の設定

前提条件 🔧

始める前に、以下を用意してください。

• 利用するサービスの API キー（該当する場合）
• Node.js（v20 以降）
• Claude Desktop や Cursor などの MCP クライアント

インストール ⚡

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

git clone https://github.com/yourusername/mcp-server-template.git
cd mcp-server-template

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

npm install

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

npm run build

カスタマイズガイド 🔧

このテンプレートを独自の MCP サーバー向けにカスタマイズするには、次の手順に従います。

1. package.json を更新し、サーバー名や詳細を設定します
2. src/index.ts を変更し、次の内容を行います。
   • API レスポンスのインターフェースを定義する
   • 実際に使用するツールとそのスキーマを追加する
   • ツールの機能を実装する
   • フォーマット処理のロジックを更新する

変更する主なファイル

• src/index.ts：サーバーのメイン実装
• package.json：パッケージのメタデータと依存関係
• .env：API キーを保存するためにこのファイルを作成します（.gitignore に追加してください）

サーバーの実行 🖥️

次のコマンドでサーバーを直接実行できます。

npm run build
node build/index.js

MCP クライアントとの連携

Claude Desktop アプリの設定

macOS の場合：

# Create the config file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Open the config file in TextEdit
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

Windows の場合：

code %APPDATA%\Claude\claude_desktop_config.json

サーバーの設定を追加します。

{
  "mcpServers": {
    "your-server-name": {
      "command": "node",
      "args": ["/path/to/your/build/index.js"],
      "env": {
        "YOUR_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor の設定

1. Cursor の設定を開きます
2. 「Features」>「MCP Servers」に移動します
3. 「+ Add New MCP Server」ボタンをクリックします
4. 次の情報を入力します。
   • Name：サーバーのニックネーム（例：「your-server-name」）を入力します
   • Type：種類として「command」を選択します
   • Command：サーバーを実行するコマンドを入力します。

     env YOUR_API_KEY=your-api-key node /path/to/your/build/index.js
     

テンプレートの構造について

• サーバーの設定：このテンプレートでは、stdio トランスポートを使用する基本的な MCP サーバーを作成します
• ツール定義：コメント付きプレースホルダーを含むツールスキーマの例
• エラー処理：コンソールへのログ出力を含む基本的なエラー処理の設定
• リクエスト処理：switch/case 構造を使ってツールリクエストを処理するためのテンプレート

貢献

このテンプレートは、独自の MCP サーバーを構築するための出発点として自由にご利用ください。テンプレートを改善した場合は、プルリクエストを通じて貢献をご検討ください。

謝辞 ✨

• MCP の仕様を提供する Model Context Protocol
• Claude Desktop を提供する Anthropic
• このテンプレートのベースとなった Tavily MCP Server