Bug: mcpServers alone does not trigger MCP connection — mcp array also required but undocumented
Description
config.json 中仅配置 mcpServers 无法使 MCP 服务器生效。运行时实际读取的是 mcp 数组来决定启动哪些服务器,但官方文档只展示了 mcpServers 和 --mcp CLI 参数,未提及 mcp 数组,导致用户按文档配置后 /mcp 始终显示无连接。
Steps to reproduce
- 在
~/.reasonix/config.json 中仅添加 mcpServers(按官方文档示例格式):
{
"mcpServers": {
"stata-mcp": {
"command": "uvx",
"args": ["stata-mcp"],
"env": { "STATA_CLI": "D:\\stata\\StataMP-64.exe" }
}
}
}
- 不添加
mcp 数组
- 启动 Reasonix:
reasonix code
- 输入
/mcp 查看连接状态
Expected behavior
/mcp 显示 stata-mcp 已连接,因为 mcpServers 中已包含完整配置。
Actual behavior
/mcp 显示无任何连接。mcpServers 仅作为配置仓库被存储,但运行时启动时读取的是 mcp 数组,由于未配置 mcp 数组,服务器从未被启动。
经三次对照实验确认:
| 实验 |
mcp 数组 |
mcpServers |
/mcp 结果 |
| 1 |
❌ |
✅ |
无连接 |
| 2 |
✅ |
✅ |
✅ 正常 |
| 3 |
❌ |
✅ |
无连接 |
Workaround
手动在 mcp 数组中添加 "name=command args" 格式的条目:
{
"mcpServers": {
"stata-mcp": {
"command": "C:\\Users\\47591\\.local\\bin\\uvx.exe",
"args": ["stata-mcp"],
"env": { "STATA_CLI": "D:\\stata\\StataMP-64.exe" }
}
},
"mcp": [
"stata-mcp=C:\\Users\\47591\\.local\\bin\\uvx.exe stata-mcp"
]
}
或使用 add_mcp_server 工具(会同时写入两个字段),重启后生效。
Impact
Environment
- OS: Windows 11
- Reasonix CLI version: 0.46.0
- Install method: npm global
- Terminal app: Windows Terminal
- Shell: PowerShell
Bug:
mcpServersalone does not trigger MCP connection —mcparray also required but undocumentedDescription
config.json中仅配置mcpServers无法使 MCP 服务器生效。运行时实际读取的是mcp数组来决定启动哪些服务器,但官方文档只展示了mcpServers和--mcpCLI 参数,未提及mcp数组,导致用户按文档配置后/mcp始终显示无连接。Steps to reproduce
~/.reasonix/config.json中仅添加mcpServers(按官方文档示例格式):{ "mcpServers": { "stata-mcp": { "command": "uvx", "args": ["stata-mcp"], "env": { "STATA_CLI": "D:\\stata\\StataMP-64.exe" } } } }mcp数组reasonix code/mcp查看连接状态Expected behavior
/mcp显示stata-mcp已连接,因为mcpServers中已包含完整配置。Actual behavior
/mcp显示无任何连接。mcpServers仅作为配置仓库被存储,但运行时启动时读取的是mcp数组,由于未配置mcp数组,服务器从未被启动。经三次对照实验确认:
mcp数组mcpServers/mcp结果Workaround
手动在
mcp数组中添加"name=command args"格式的条目:{ "mcpServers": { "stata-mcp": { "command": "C:\\Users\\47591\\.local\\bin\\uvx.exe", "args": ["stata-mcp"], "env": { "STATA_CLI": "D:\\stata\\StataMP-64.exe" } } }, "mcp": [ "stata-mcp=C:\\Users\\47591\\.local\\bin\\uvx.exe stata-mcp" ] }或使用
add_mcp_server工具(会同时写入两个字段),重启后生效。Impact
Environment