MCP Server Setup Guide

🚀 MCP サーバー設定ガイド

MCP サーバーの設定に関するガイドです。このガイドでは、設定ファイルの位置、Volta 環境での設定例、常见问题のトラブルシューティング、機能の検証方法について説明します。

🚀 クイックスタート

🔧 設定

📁 MCP 設定ファイルの位置

設定ファイルは以下のパスにあります：

• Cursor の場合：~/Library/Application Support/Cursor/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Claude Desktop の場合：~/Library/Application Support/Claude/claude_desktop_config.json

⚙️ Volta 環境での設定例

macOS で Volta を使用する場合、以下の設定が正常に動作します：

{
  "mcpServers": {
    "github.com/modelcontextprotocol/servers/tree/main/src/github": {
      "command": "/Users/username/.volta/bin/npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

🛠️ 常见问题のトラブルシューティング

❌ 失敗するパターン

1. node コマンドを直接実行する場合

{
  "command": "node",
  "args": [
    "/path/to/server-github/build/index.js"
  ]
}

エラー：spawn node ENOENT

2. volta コマンドを使用する場合

{
  "command": "/Users/username/.volta/bin/volta",
  "args": [
    "run",
    "node",
    "/path/to/server-github/build/index.js"
  ]
}

エラー：接続タイムアウト

✅ 成功するパターン

Volta の npx の完全パスを使用することで問題を解決できます：

{
  "command": "/Users/username/.volta/bin/npx",
  "args": [
    "-y",
    "@modelcontextprotocol/server-github"
  ]
}

💻 使用例

基本的な使用法

サーバーが正しく設定されていることを確認するには、以下の操作を試してください：

// リポジトリ検索
{
  "query": "modelcontextprotocol",
  "page": 1,
  "perPage": 5
}

正常に結果が返されれば、設定は成功しています。