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 值保持為字串。
- 為密钥使用占位符。
- 使用最小权限的绝对路径。
- 每次更改后重新驗證。
- 生產前处理警告。
常见問題
關于常见调试問題和数據私隱的可展開解答。
相關工具
探索可与此工具配合使用的其他相關实用工具。
官方文件与参考
本工具的权威规范与平台文件。