🛠️ MCP 客户端使用完全指南

在 5+ 主流 AI 客户端中安装和配置 MCP Server（Model Context Protocol）。覆盖 Claude Desktop、Cursor、VS Code、Cline、Windsurf 等。含完整配置文件路径、JSON 示例、调试技巧。

🤖

Claude Desktop

Anthropic · Anthropic 官方桌面应用，原生支持 MCP 协议。

📁 配置文件路径

macOS:~/Library/Application Support/Claude/claude_desktop_config.json
Windows:%APPDATA%\Claude\claude_desktop_config.json
Linux:~/.config/Claude/claude_desktop_config.json

📝 配置 JSON 示例

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "GITHUB_PERSONAL_ACCESS_TOKEN", "ghcr.io/github/github-mcp-server"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx"
      }
    },
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/yourname/Documents"]
    }
  }
}

💡 提示

•在 Claude Desktop 设置 > Developer > Edit Config 可直接编辑
•重启 Claude Desktop 后生效
•菜单栏 > Help > Troubleshooting 可查看日志

⚡

Cursor

Cursor · AI 代码编辑器（VS Code Fork），完整支持 MCP 协议。

📁 配置文件路径

macOS:~/.cursor/mcp.json
Windows:%USERPROFILE%\.cursor\mcp.json
Linux:~/.cursor/mcp.json

📝 配置 JSON 示例

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx" }
    },
    "postgres": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-postgres"],
      "env": { "POSTGRES_CONNECTION_STRING": "postgresql://..." }
    }
  }
}

💡 提示

•Cursor Settings > Features > Model Context Protocol 添加 Server
•支持 stdio 和 SSE 两种模式
•可在 Composer 中通过 @ 触发 MCP 工具

💙

VS Code

Microsoft · 通过 GitHub Copilot Chat + MCP 扩展支持。

📁 配置文件路径

macOS:~/.vscode/mcp.json
Windows:%USERPROFILE%\.vscode\mcp.json
Linux:~/.vscode/mcp.json

📝 配置 JSON 示例

{
  "servers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    },
    "filesystem": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "${workspaceFolder}"]
    }
  }
}

💡 提示

•需要安装 GitHub Copilot Chat 扩展
•VS Code 1.85+ 版本支持
•在 Copilot Chat 输入 / 可以查看 MCP 工具

🧠

Cline (VS Code 扩展)

Cline · VS Code 中的 AI Agent 扩展，深度集成 MCP。

📁 配置文件路径

macOS:通过 Cline 面板 > MCP Servers > Configure
Windows:通过 Cline 面板 > MCP Servers > Configure
Linux:通过 Cline 面板 > MCP Servers > Configure

📝 配置 JSON 示例

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_xxx" }
    }
  }
}

💡 提示

•可在 Cline 面板内一键安装市场 MCP
•支持自动批准 / 每次询问 / 禁止三种权限
•日志输出在 Cline > Output 面板

🌊

Windsurf

Codeium · Codeium 推出的 AI IDE，原生 MCP 支持。

📁 配置文件路径

macOS:~/.codeium/windsurf/mcp_config.json
Windows:%USERPROFILE%\.codeium\windsurf\mcp_config.json
Linux:~/.codeium/windsurf/mcp_config.json

📝 配置 JSON 示例

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    }
  }
}

💡 提示

•Windsurf Settings > Cascade > Model Context
•支持 Cascade 流程中自动调用 MCP 工具
•免费用户即可使用 MCP

❓ 常见问题 (FAQ)

Q1.MCP Server 是什么？▼

MCP（Model Context Protocol）是 Anthropic 2024 年 11 月推出的开放标准协议，让 LLM（如 Claude、GPT-4）通过统一接口调用外部工具和数据源。简单说，MCP Server 就是给 AI 用的"USB-C 接口"。

Q2.哪些 AI 客户端支持 MCP？▼

截至 2026 年 5 月，原生支持 MCP 的客户端包括：Claude Desktop、Cursor、VS Code（1.85+）、Cline、Windsurf、Continue、Zed、Replit、Sourcegraph Cody 等。

Q3.MCP Server 和 ChatGPT Plugin 有什么区别？▼

MCP 是开源、开放标准协议，任何客户端和服务器都可以使用；而 ChatGPT Plugin 仅限 OpenAI 生态。MCP 客户端支持本地 stdio 模式（无需公网）和远程 HTTP 模式，更适合个人开发。

Q4.MCP 配置文件存放在哪里？▼

每个客户端的配置文件路径不同。Claude Desktop 在 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)；Cursor 在 ~/.cursor/mcp.json。详细路径见上方各客户端介绍。

Q5.MCP Server 之间的权限如何管理？▼

MCP 客户端可对每个 MCP 工具设置 allow / deny / ask 权限。Claude Desktop 默认每次询问；Cursor 默认为自动；Cline 支持三种粒度。建议敏感操作（如数据库写入、文件删除）保持 ask 模式。

Q6.如何在本地调试 MCP Server？▼

推荐使用 MCP Inspector（@modelcontextprotocol/inspector），可通过 npx @modelcontextprotocol/inspector 命令启动 Web 调试界面，测试 MCP Server 的所有 tool 行为。

Q7.MCP Server 是否需要 API Key？▼

不一定。文件系统、本地数据库等本地 MCP 不需要；GitHub、OpenAI、Slack 等远程服务需要相应 API Key。所有 API Key 建议放在 env 字段而非 args 中，避免泄露。

查看全部 100+ MCP Server

所有 MCP 都有完整安装命令、配置 JSON 和客户端示例

浏览所有 MCP →🔍 主题导航