MCP Server Setup Guide

🚀 MCP 服務器設置指南

本指南將詳細介紹 MCP 服務器的設置方法，包括配置文件位置、配置示例以及常見問題排查等內容，幫助你順利完成 MCP 服務器的設置。

🚀 快速開始

配置

📄 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
}

如果正常返回結果，則說明配置成功。