参考
mcp.json 参考
MCP 服务器配置的字段与校验规则
mcp.json 由 mcp-client 扩展读取，位置与覆盖关系见接入 MCP 服务器。JSON Schema 位于包内 resources/mcp.schema.json（推荐用 $schema 引用获得编辑器校验）。
顶层结构
Prop
Type
mcpServers 的键须匹配 ^[A-Za-z0-9_-]{1,64}$；disabledServers/enabledServers 的项非空且不重复。
服务器定义（三选一）
三种形态按 type 区分，互斥（stdio 形态禁止 url，http/sse 形态禁止 command）。
{
"mcpServers": {
"fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"],
"env": {}
}
}
}stdio（type 可省略，默认）
Prop
Type
http / sse
Prop
Type
公共字段（三型共有）
Prop
Type
工具名默认为 <服务器名>_<工具名>；prefix 为字符串时替换服务器名，为 false 时直接使用清洗后的原始工具名。同一服务器内清洗后重名会自动追加 _2、_3 后缀，跨服务器重名会让回合失败。
完整示例
来自仓库 resources/mcp.example.json：
{
"$schema": "./mcp.schema.json",
"mcpServers": {
"fetch": {
"command": "uvx",
"args": ["mcp-server-fetch"],
"env": {}
},
"docs": {
"type": "http",
"url": "https://example.com/mcp",
"headers": { "Authorization": "Bearer <token>" },
"timeout": 30000,
"instructions": true
},
"legacy": {
"type": "sse",
"url": "https://example.com/sse"
},
"sandbox": {
"command": "node",
"args": ["./sandbox-mcp.js"],
"enabled": false
}
},
"disabledServers": [],
"enabledServers": []
}加载行为
- 解析：JSON 解析或 Schema 校验失败时回退到空配置（无服务器、全默认），日志有 error；不会因此阻塞其它启动流程。
- 逐服务器校验：某个服务器定义不合法只跳过该服务器，其余照常连接。
- 连接失败只记日志并跳过该服务器，不影响其余服务器。
没有自动重连
连接在启动（profile 装配）时建立，失败的服务器在下次重载前不会重试；服务器运行中变更工具列表会自动刷新。