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
}

如果正常返回结果，则说明配置成功。