MCP 服务器配置设置指南 — Claude Desktop 和 AI 代理的模型上下文协议

发布于 2026 年 5 月 3 日

MCP（模型上下文协议）是一个开放协议，将 AI 代理连接到外部工具和数据源。如果你使用 Claude Desktop、Cursor 或任何兼容 MCP 的 AI 编程代理，你需要一个格式正确的 mcp-config.json 或 claude_desktop_config.json 文件来连接服务器。

本指南涵盖了你需要的一切：从基本配置结构到实际示例。使用我们的 MCP 服务器配置生成器跳过手动设置。

跳过手动工作： 使用我们的免费在线 MCP 配置生成器 → 秒级生成你的 MCP 配置。

什么是 MCP 服务器配置？

MCP 服务器配置是一个 JSON 文件，告诉你的 AI 代理要连接哪些服务器、如何找到它们以及它们需要哪些环境变量。每个服务器提供特定的工具 — 文件系统访问、数据库查询、网络搜索或自定义 API。

配置结构如下：

{
  "mcpServers": {
    "server-name": {
      "command": "node",
      "args": ["/path/to/server.mjs"],
      "env": {
        "API_KEY": "your-key-here"
      }
    }
  }
}

配置文件在哪？

位置取决于你的 AI 代理：

Claude Desktop： ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）
Cursor： 通过 Cursor 设置 → MCP Servers 标签页配置
VS Code with Continue： 项目根目录下的 .continuum/config.json
自定义代理： 通过 MCP SDK 编程加载

常见服务器配置示例

文件系统服务器

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/you/projects"
      ]
    }
  }
}

GitHub MCP 服务器

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

数据库（PostgreSQL）

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@anthropic/server-postgres",
        "postgresql://user:pass@localhost:5432/mydb"
      ]
    }
  }
}

常见错误和故障排查

路径错误： 始终使用服务器脚本的绝对路径。相对路径在代理从不同目录运行时会导致失败。
缺少环境变量： 需要 API 密钥或令牌的服务器会静默失败。仔细检查你的 env 块。
权限错误： 文件系统服务器只能访问你明确允许的目录。添加所有需要的路径。
版本不匹配： 运行 npx @modelcontextprotocol/server-name --version 验证服务器兼容性。
JSON 语法： JSON 中的尾逗号会破坏配置。如果不确定，使用验证器检查。

为什么要用配置生成器？

手写 MCP 配置容易出错。一个放错位置的逗号或错误路径会破坏整个设置。我们的 MCP 配置生成器自动处理所有格式化和验证：

从常用服务器模板中选择
自动生成无语法错误的有效 JSON
支持环境变量
可直接复制粘贴到 Claude Desktop、Cursor 或 VS Code

立即生成你的 MCP 配置 →