MCP JS Server Template

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

概要

これは、Claude Desktop との連携向けに、JavaScript で Model Context Protocol（MCP）サーバーを作成するための簡易テンプレートです。最小限の定型コードで、カスタム MCP サーバーを開発するための基本構成を提供します。

機能

• 標準的な MCP サーバーの初期化を実装
• 2 つの基本ツール about と hello を提供
• MCP プロトコルバージョン 2024-11-05 に準拠
• サーバーの実装に @modelcontextprotocol/sdk を使用
• エラー処理とログ記録を含む

前提条件

• Node.js（v16 以降）
• Claude Desktop
• @modelcontextprotocol/sdk npm パッケージ

インストール

1. リポジトリをクローンします
2. 依存関係をインストールします：

npm install @modelcontextprotocol/sdk

Claude Desktop の設定

Claude Desktop の設定ファイルに追加します：

場所：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

設定例：

{
  "mcpServers": {
    "template-server": {
      "command": "node",
      "args": [
        "/full/path/to/simplified-template-mcp-server.js"
      ],
      "env": {
        "NODE_OPTIONS": "--no-deprecation"
      }
    }
  }
}

利用可能なツール

1. about

MCP サーバーに関する情報を返します。

2. hello

任意の名前パラメーターを指定して、あいさつを返します。

Claude での使用例：

hello with name="Claude"

テンプレートの拡張

独自の MCP サーバーを作成するには：

1. このテンプレートをコピーします
2. TOOLS 配列を変更します
3. server.fallbackRequestHandler にカスタムツールハンドラーを実装します
4. サーバー名とバージョンを更新します

制限事項

• エラー処理は最小限です
• 高度なセキュリティ機能はありません
• カスタム実装の出発点として想定されています

貢献

貢献を歓迎します！プルリクエストを送信するか、Issue を作成してください。

ライセンス

MIT ライセンス