MCP 配置生成器与校验器
为 Claude Code、Claude Desktop、Cursor、VS Code 生成正确的 MCP 服务器配置（mcp.json），或粘贴现有配置排查报错：trailing comma、注释、command 带参数、根键拼写等最常见的坑。全部在浏览器本地完成，配置和密钥不会上传。
.mcp.json (project root)
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/path/to/allowed/dir"
]
}
}
}或用 CLI 一条命令添加
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/allowed/dir
提示：密钥请勿直接提交进仓库——Claude Code 的 .mcp.json 支持 ${VAR} 环境变量引用。
使用指南 / 为什么使用此工具 / 常见问题
使用指南
先选择你的客户端——Claude Code、Claude Desktop、Cursor 或 VS Code，它们读取的配置文件路径和结构各不相同。生成模式下，可从内置模板（filesystem、GitHub、Postgres、Playwright 等）一键添加服务器，或手动填表：stdio 服务器的可执行文件填在 command，每个参数放进 args；远程服务器直接粘 URL。右侧实时生成正确的 JSON 并标注应保存到的文件路径，选 Claude Code 时还会给出可直接执行的 claude mcp add 命令。校验模式下，粘贴现有配置即可得到逐条报错说明。
为什么使用此工具
MCP 配不通大多不是服务器的问题，而是配置文件的问题：最后一项后面多了个逗号（trailing comma）、严格 JSON 里留了注释、整条命令塞进了 command 字段而没拆进 args、或者根键用错（mcpServers 和 servers 在不同客户端间不通用）。客户端的报错信息几乎从不把这些说清楚。这个工具把规则直接编码进去：生成的配置对每个客户端天生正确，校验器会指出具体错在哪、怎么改，而不是抛一句通用的解析失败。全部在浏览器本地运行——这很重要，因为 MCP 配置里常常带着 API key。
常见问题
- 各客户端分别从哪个文件读 MCP 配置？
- Claude Code 读项目根目录的 .mcp.json（另有用户级配置），Claude Desktop 读应用目录下的 claude_desktop_config.json，Cursor 读 .cursor/mcp.json，VS Code 读 .vscode/mcp.json。前三者根键是 mcpServers，VS Code 用 servers。
- 我的 mcp.json 为什么解析失败？
- 最常见的两个原因：对象或数组最后一项后面的 trailing comma，以及 // 注释——两者在 JavaScript 里合法，但严格 JSON 不允许。把配置粘进校验模式，会直接指出出错的行。
- stdio 和 HTTP 传输有什么区别？
- stdio 服务器是客户端直接拉起的本地进程（command + args），适合访问本地文件或本机运行的工具；HTTP 服务器是通过 URL 连接的远程端点——新的 Streamable HTTP 传输已取代旧的 SSE。
- 为什么参数必须放进 args 数组，不能写在 command 里？
- 客户端是直接执行 command 而不经过 shell，所以 "command": "npx -y server" 会去找一个字面上叫「npx -y server」的可执行文件，必然失败。可执行文件放 command，每个参数作为独立字符串放 args——这是 stdio 配置最常见的错误，校验器会专门检查。
- 怎么避免把 API key 提交进仓库？
- Claude Code 的 .mcp.json 支持 ${VAR} 环境变量引用，可以放心提交配置、把密钥留在环境变量里。其他客户端建议把含密钥的配置排除在版本控制外，或在部署时注入。
- 我的配置会被上传吗？
- 不会。生成器和校验器都是纯前端 JavaScript——你的配置（包括其中的 token）不会离开浏览器。无需注册，也不记录任何输入。