Tool overview
什么是MCP 服务器验证器？
MCP 服务器验证器是一款帮助您校验 mcpServers JSON 客户端配置的开发者工具。
为什么使用MCP 服务器验证器？
在需要校验 mcpServers JSON 客户端配置时提升可读性与效率，且不会将数据上传到服务器。
核心功能
客户端隐私保护、即时结果与一键复制。校验 mcpServers JSON 客户端配置
使用方法
按照以下步骤使用上方工具并获得准确结果。
- 粘贴包含顶级 mcpServers 对象的 Cursor 或 Claude Desktop JSON 配置。
- 查看校验报告中的错误（阻塞）与警告（非阻塞），以及 JSON 指针路径。
- 修复传输：stdio 需要 command（+ args）；远程需要有效的 http/https url。
- 确保 env 仅含字符串，args 数组仅含字符串。
- 尽可能移除同时设置 command+url 的条目以及标为警告的未知键。
- 重新验证直到 ok 为 true — 仅有警告不会失败，但应视为生产债务。
- 将修正后的 JSON 粘贴回客户端配置并重新加载 MCP 服务器。
- 共享团队模板时把问题报告复制到 PR 或 CI 清单；密钥保持为占位符。
MCP 验证器 — 完整指南与用例
权威指南：错误与警告、stdio 与 HTTP、Cursor 与 Claude Desktop 用例、env 字符串规则、修复指南与密钥卫生。
MCP Validator 指南 — 从这里开始
此验证器做什么：本指南说明如何在本地验证 mcpServers JSON 配置。请粘贴不含密钥的内容，并在使用 Cursor 或 Claude Desktop 前修复问题。
MCP Validator 的作用
MCP Validator 会在浏览器中检查 mcpServers 条目、传输方式和 JSON 类型，找出客户端无法启动的配置。
包含 JSON 路径和可执行修复建议的本地报告
- 包含 JSON 路径和可执行修复建议的本地报告
- 包含 JSON 路径和可执行修复建议的本地报告: mcpServers, command, args, url, env
- 包含 JSON 路径和可执行修复建议的本地报告: stdio, http, https
- 包含 JSON 路径和可执行修复建议的本地报告: JSON, ok
在粘贴或共享 MCP 配置之前使用
- 在粘贴或共享 MCP 配置之前使用
- 在粘贴或共享 MCP 配置之前使用: Cursor mcp.json
- 在粘贴或共享 MCP 配置之前使用: Claude Desktop
- 在粘贴或共享 MCP 配置之前使用: CI / PR
需要创建 Schema 或提示词时使用相关工具
- 需要创建 Schema 或提示词时使用相关工具
- 需要创建 Schema 或提示词时使用相关工具: AI Agent Builder
- 需要创建 Schema 或提示词时使用相关工具: JSON Schema
错误与警告 — 什么会阻止粘贴
错误：配置阻止验证
严重程度说明
| 严重程度说明 | 对 ok 的影响 | 常见原因 |
|---|---|---|
| 错误：配置阻止验证 | 对 ok 的影响: ok = false | 常见原因 |
| 警告：请在生产环境前检查此细节 | 对 ok 的影响: ok | 常见原因 |
警告：请在生产环境前检查此细节
分步操作：粘贴、lint、修复、粘贴回去
此工具如何帮助
- 粘贴包含 mcpServers 的 JSON。
- 先修复错误。
- 检查 command、args、url 和 env。
- 每个服务器只选择一种传输方式。
- 远程服务器使用 http:// 或 https://。
- 将 env 值转换为字符串。
- 重新验证直到 ok 为 true。
- 将修正后的 JSON 粘贴回客户端。
用例：重新加载前修复 Cursor mcp.json
错误：配置阻止验证 Cursor mcp.json.
此工具如何帮助
- 粘贴包含 mcpServers 的 JSON。
- 先修复错误。
- 检查 command、args、url 和 env。
- 每个服务器只选择一种传输方式。
结果：清晰、已验证且可直接使用的 MCP 配置。
用例：Claude Desktop 远程 MCP URL
错误：配置阻止验证 Claude Desktop.
此工具如何帮助
- 粘贴包含 mcpServers 的 JSON。
- 先修复错误。
- 检查 command、args、url 和 env。
- 每个服务器只选择一种传输方式。
结果：清晰、已验证且可直接使用的 MCP 配置。
用例：在 PR 审查中 lint MCP 模板
错误：配置阻止验证 CI / PR.
此工具如何帮助
- 粘贴包含 mcpServers 的 JSON。
- 先修复错误。
- 检查 command、args、url 和 env。
- 每个服务器只选择一种传输方式。
结果：清晰、已验证且可直接使用的 MCP 配置。
用例：调试期间的密钥卫生
错误：配置阻止验证 env.
此工具如何帮助
- 粘贴包含 mcpServers 的 JSON。
- 先修复错误。
- 检查 command、args、url 和 env。
- 每个服务器只选择一种传输方式。
结果：清晰、已验证且可直接使用的 MCP 配置。
stdio 与 HTTP/HTTPS 传输规则
传输形式
传输形式
| 传输形式 | 必填字段 | 说明 |
|---|---|---|
| stdio | command; args | 说明 |
| HTTP / HTTPS | url (http:// or https://) | 说明 |
说明: env, headers, disabled.
env 值必须是字符串
env: 必填字段
- env: 必填字段
- 必填字段
- JSON
- mcpServers
修复：缺少 command 或 url
错误：配置阻止验证: command or url.
发生原因
发生原因
诊断
诊断
修复
- 粘贴包含 mcpServers 的 JSON。
- 先修复错误。
- 检查 command、args、url 和 env。
修复：非字符串 env 值
错误：配置阻止验证: env.
发生原因
发生原因
诊断
诊断
修复
- 粘贴包含 mcpServers 的 JSON。
- 先修复错误。
- 检查 command、args、url 和 env。
警告：请在生产环境前检查此细节
修复：错误的根 envelope
错误：配置阻止验证: mcpServers.
发生原因
发生原因
诊断
诊断
修复
- 粘贴包含 mcpServers 的 JSON。
- 先修复错误。
- 检查 command、args、url 和 env。
MCP 验证最佳实践
- 粘贴到 Cursor 或 Claude Desktop 前先验证。
- 使用 command 或 url，不能同时使用。
- 将 args 保持为字符串数组。
- 将 env 值保持为字符串。
- 为密钥使用占位符。
- 使用最小权限的绝对路径。
- 每次更改后重新验证。
- 生产前处理警告。
常见问题
关于常见调试问题和数据隐私的可展开解答。
相关工具
探索可与此工具配合使用的其他相关实用工具。
官方文档与参考
本工具的权威规范与平台文档。