MCP Server Setup Guide

🚀 MCP 服务器设置指南

MCP 服务器设置指南旨在帮助用户正确配置 MCP 服务器，解决常见问题，并验证服务器功能是否正常。

🚀 快速开始

本指南将详细介绍 MCP 服务器的配置方法，包括设置文件位置、使用 Volta 环境的配置示例、常见问题排查以及功能验证。

✨ 主要特性

• 提供详细的 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
}

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