Claude MCP Get

Claude MCP Get

Windows システムで Claude Desktop 用の Model Context Protocol（MCP）サーバーをインストールおよび設定するための包括的なツールキットです。

概要

このリポジトリには、Windows ユーザーが Claude Desktop で Model Context Protocol（MCP）サーバーを問題なくインストールして使用できるようにするスクリプト、設定、ドキュメントが含まれています。Windows で MCP 接続を妨げる一般的な問題、特に npx コマンド、パスの解決、複数の Node.js インストールに関する問題の解決に重点を置いています。

主な機能

• Node.js のインストールを特定する診断ツール
• よくある落とし穴を回避するインストールスクリプト
• 絶対パスを使用した設定テンプレート
• 「Could not attach to MCP server」エラーのトラブルシューティングガイド
• NVM と Node.js のパスに関する問題の解決策

クイックスタート

1. このリポジトリをクローンします
2. find-nodejs.bat を実行して、Node.js のインストールを特定します
3. 複数のインストールがある場合は、cleanup-nodejs.bat を実行します
4. install-mcp.bat を実行して、任意の MCP サーバーをインストールします
5. 表示される設定手順に従います

Windows でよくある問題と解決策

NPX 接続の失敗

Windows で最もよくある問題は、claude_desktop_config.json 内の npx コマンドを使用すると MCP サーバーが接続に失敗することです。これは、Claude Desktop が Windows 上でサブプロセスを起動する方法が原因です。

解決策： 次のように、絶対パスを指定して node を直接実行します。

{
  "mcpServers": {
    "server-name": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": [
        "C:\\Users\\Username\\AppData\\Roaming\\npm\\node_modules\\@modelcontextprotocol\\server-name\\dist\\index.js",
        "parameter1", "parameter2"
      ],
      "env": {
        "APPDATA": "C:\\Users\\Username\\AppData\\Roaming\\",
        "PATH": "C:\\Program Files\\nodejs",
        "NODE_PATH": "C:\\Users\\Username\\AppData\\Roaming\\npm\\node_modules"
      }
    }
  }
}

複数の Node.js インストール

複数の Node.js をインストールしていると（特に NVM を使用している場合）、パスの解決に問題が発生します。

解決策： デフォルトの場所にある標準の Node.js インストールを使用し、絶対パスを指定します。

タスクマネージャーでの再起動が必要

Claude Desktop を閉じて再度開くだけでは、設定が完全に再読み込みされないことがあります。

解決策： 再起動する前に、タスクマネージャーですべての Claude Desktop プロセスを終了します。

ドキュメント

• インストールガイド
• トラブルシューティングガイド
• MCP サーバーリファレンス
• 設定テンプレート

スクリプト

• find-nodejs.bat - システム上のすべての Node.js インストールを特定します
• cleanup-nodejs.bat - npm キャッシュをクリーンアップし、よくあるインストールの問題を修正します
• install-mcp.bat - 適切なパスを指定して MCP サーバーをグローバルにインストールします
• run-server.bat - Claude Desktop の外部でテスト用に MCP サーバーを実行します

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

ライセンス

MIT ライセンス

謝辞

• Model Context Protocol チーム
• MCP servers GitHub issue #40 への貢献者