MCP Server 配置校验器

在线校验 Model Context Protocol (MCP) server 配置 JSON 是否符合规范,快速定位 mcpServers 条目中缺失字段、类型错误等问题。

免费在线工具

Loading…

使用说明

将 MCP 配置 JSON(通常是 Claude Desktop、Cursor 等客户端 mcpServers 字段所在的配置文件内容)粘贴到输入框,点击“校验配置”即可看到结果。

校验规则:顶层必须是包含 mcpServers 对象的 JSON;每个 server 条目的 command 为必填字符串;args(可选)必须是字符串数组;env(可选)必须是值均为字符串的键值对象。如果条目里出现 url 或 type 为 sse/http,会识别为远程 server,跳过 stdio 相关字段(command)的强制校验,仅给出提示。未知字段不会导致校验失败,只作为警告展示。

点击“加载示例数据”查看一个校验通过的正确配置,点击“加载错误示例”查看一个包含类型错误(args不是数组)的配置及对应报错信息。本工具仅做纯前端结构校验,不会实际连接或启动任何 server,也不会上传配置内容。

功能介绍

Model Context Protocol(MCP)是 Anthropic 推出的开放协议,用于让 AI 应用(如 Claude Desktop、各类 AI 编程工具)以标准化方式连接外部数据源和工具。MCP 客户端配置文件里的 mcpServers 字段声明了要启动哪些 MCP server,以及每个 server 的启动命令、参数和环境变量。

手写这类配置文件时容易出现字段名拼写错误、args 误写成字符串而非数组、env 值类型不对等问题,启动时才会报错,排查成本较高。本工具在浏览器本地对配置做静态结构校验,逐条给出具体报错位置(JSON path)和错误原因,帮助在启动前发现配置问题。

校验逻辑区分“错误”(会导致 server 无法正常启动的结构性问题)和“警告”(未知字段等不影响运行的提示),并对远程 server(带 url 或 type: sse/http)采用更宽松的规则,不强制要求 command 字段。

使用场景

配置 Claude Desktop / Cursor 等 MCP 客户端前自查

在把 mcpServers 配置写入客户端配置文件前,先粘贴到本工具校验结构是否正确,避免因为拼写或类型错误导致 server 无法启动。

排查 MCP server 启动失败问题

当 MCP server 报错无法连接或启动时,先用本工具确认配置文件结构是否合法,排除配置层面的问题后再排查 server 本身。

编写/分享 MCP server 配置示例

为团队或文档编写 mcpServers 配置示例时,用本工具确认格式正确,减少他人复制配置后出现低级错误的概率。

学习 MCP 配置规范

通过“加载示例数据”和“加载错误示例”对比正确与错误配置的差异,快速理解 mcpServers 各字段的规范要求。

常见问题

这个工具会真的连接或启动 MCP server 吗?

不会。本工具只在浏览器本地对 JSON 文本做纯静态结构校验,不会发起任何网络请求,也不会执行 command 字段里的命令,配置内容不会上传到任何服务器。

args 和 env 字段可以缺省吗?

可以。args 和 env 都是可选字段,缺省时不会报错;但如果提供了,args 必须是字符串数组,env 必须是值全部为字符串的对象,类型不对会报错。

远程 MCP server(通过 URL 连接)也能校验吗?

可以。当条目包含 url 字段或 type 为 sse/http 时,工具会识别为远程 server 配置,不会强制要求 command 字段必填,只对存在的字段做类型校验。

校验不通过时应该怎么改?

校验结果会按 JSON path(如 mcpServers.filesystem.args)标出具体是哪个字段出了问题,以及问题类型(如“不是必填字符串”“不是字符串数组”),按提示修改对应字段即可,修改后可重新点击“校验配置”验证。