MCP JS Server Template

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

このテンプレートは、Claude Desktopと統合するModel Context Protocol (MCP) サーバーを簡単に作成するためのものです。カスタムMCPサーバーを開発する際の基本構造を提供し、ボイラープレートコードを減らします。

🚀 クイックスタート

このMCP JSサーバーテンプレートを使うことで、Claude Desktopと統合したMCPサーバーを迅速に構築できます。以下の手順に沿ってセットアップしてください。

✨ 主な機能

• 標準的なMCPサーバーの初期化を実装します。
• about と hello の2つの基本的なツールを提供します。
• 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. サーバー名とバージョンを更新します。

制限事項

• エラー処理は簡素です。
• 高度なセキュリティ機能はありません。
• カスタム実装の起点として提供されています。

貢献

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

📄 ライセンス

MIT License