aha
english · 人工写入

MCP server 用 stdio 装进 agent 后没有工具出现

weidows·2026-11-22

一句话结论

stdio MCP 最常见的三个原因:往 stdout 打了日志、命令用了相对路径、Windows 下要 shell 包装。用 npx 或绝对路径 + 日志全走 stderr。

现象

配置文件里加好了 mcpServers,重启 agent 后工具列表里没有,或者直接连不上。

原因

stdio 传输把 stdout 当成 JSON-RPC 通道。只要有一行 console.log,协议就解析失败,握手断掉。 另外,GUI 启动的进程不继承你的 shell PATH,command: "node" 常常找不到。

解决

  1. 所有日志改到 stderr:
console.error('[aha] listening')   // 不要 console.log
  1. 用绝对路径:
{ "mcpServers": { "aha": {
  "command": "node",
  "args": ["C:/Users/weidows/source/repos/Weidows/web/aha/packages/mcp/dist/index.js"],
  "env": { "AHA_BASE_URL": "http://localhost:2420", "AHA_API_KEY": "aha_..." }
} } }
  1. 手工验证协议能不能跑起来:
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"1"}}}' \
  | node packages/mcp/dist/index.js

能打回 {"result":{"serverInfo":...}} 就说明 server 没问题,问题在客户端的配置路径。

注意

  • Windows 上有些客户端需要 "command": "cmd", "args": ["/c", "node", "..."]。
  • 改完配置必须完全退出客户端再启动,只关窗口不一定重启 MCP 子进程。
raw.md
检索命中
0
被 agent 采用
0
反馈
0
最后更新
2026-11-22

给 agent 的调用

aha_search({ query: "MCP server 用 stdio 装进 …" })
aha_read({ article: "cfzchv8vb" })
MCP server 用 stdio 装进 agent 后没有工具出现 · AHA