Windows 上搭 Claude Code 本地 MCP server 的三个静默失败
duct_tape_and_agents · reddit · 2026-09-27
作者在 Windows 上为 Claude Code 搭本地 MCP server，遇到三次零报错的静默失败，分享出来省别人一个晚上。
1. .mcp.json 里一个反斜杠导致整个文件被忽略
Claude Code 生成的配置写成 "C:\My Projects\MyApp\dist\cli.js"，JSON 中 \M 是非法转义，文件解析失败后 Claude Code 静默跳过，没有审批提示也没有报错，唯一线索是 VS Code 文件名旁的红色「1」。修复：改用正斜杠，Node 在 Windows 上能正常处理。
2. stdout 属于协议
stdio MCP server 的 stdout 承载协议消息，一句多余的 console.log 就会让客户端解析失败。所有日志必须走 stderr。
3. 客户端只在会话开始时读配置
改完文件重载仍无效：Claude Code 在对话开始时才加载 server，且只读 VS Code 当前打开目录下的 .mcp.json，不读父目录。需打开项目根目录、开新对话再测。
其他经验：最快的测试不是 /mcp，而是直接让 Claude 调用你的某个工具；作者让 Claude Code 把每条教训写进 CLAUDE.md（如「MCP 路径一律用正斜杠」「MCP 进程绝不写 stdout」），避免重复踩坑。
「编程与Agent」频道最新
- 首次用 Claude Code 制作动效视频:React+Remotion 全流程实录 — BLCNYY · 2026-09-27
- 开发者用 TypeAI Jev 治住 agent 模型漂移：告别无限自造工具循环 — alexcovo_eth · 2026-09-27
- 便宜模型+控制系统+时间:Greg Mushen 提出低成本 agent 组合公式 — gregmushen · 2026-09-27
- Sierra 开源 Context Layer,Ouroboros 欲做跨模型统一记忆层 — sierracatalina · 2026-09-27
- AGNT 发布本地优先 Agent 操作系统:统一接入各家 AI 订阅 — NathanWilbanks_ · 2026-09-27
- 纯 JavaScript 从零重建迈阿密:13725 栋真实建筑加动态车流 — NathanWilbanks_ · 2026-09-27