MCP Template

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

このテンプレートは、モデルコンテキストプロトコル (MCP) サーバーを構築するためのクリーンなスタート地点を提供します。

🚀 クイックスタート

モデルコンテキストプロトコル（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の場合：

# ファイルが存在しない場合は作成する
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# 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. 機能 > MCPサーバーに移動します。
3. “+ 新しいMCPサーバーを追加” ボタンをクリックします。
4. 以下の情報を入力します：
   • 名前：サーバーのニックネームを入力します（例：“your-server-name”）
   • タイプ：“コマンド” を選択します。
   • コマンド：サーバーを実行するコマンドを入力します：

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

📚 ドキュメント

テンプレート構造の説明

• サーバー設定：このテンプレートは、stdioトランスポートを持つ基本的なMCPサーバーを作成します。
• ツール定義：コメント付きのサンプルツールスキーマが含まれています。
• エラーハンドリング：基本的なエラーハンドリング設定とコンソールロギングがあります。
• リクエスト処理：switch/case構造を使ったリクエスト処理テンプレートが用意されています。

🔧 技術詳細

このテンプレートは、MCP SDKを利用して基本的なMCPサーバーを構築します。サーバーはstdioトランスポートを使用しており、エラーハンドリングや環境変数の設定などの基本的な機能を備えています。また、サンプルツール定義やリクエスト処理のテンプレートも提供されています。

貢献

このテンプレートを独自のMCPサーバーの起点として自由に使用してください。テンプレートを改良した場合は、プルリクエストで貢献を検討してください！

📄 ライセンス

謝辞

• モデルコンテキストプロトコル がMCP仕様を提供しています。
• AnthropicのClaude Desktop
• Tavily MCPサーバー、このテンプレートはこのサーバーをベースにしています。