feat(bridge): 新增 stdio↔TCP 桥，让标准 MCP 客户端可直连 CAD 基座 #8

2026-10-14T00:44:23+08:00

2026-10-14 00:44:23 +08:00

标准 MCP 客户端（Claude Desktop / CodeBuddy / MCP Inspector）只实现 stdio 与
Streamable HTTP，无法直连 cad_mcp_frame 的自定义裸 TCP。新增 mcp_bridge 包在
客户端与基座之间做协议适配，CAD 侧零改动：

合成基座缺失的生命周期：initialize（含协议版本协商、capabilities、serverInfo）
与 ping；notifications/* 按规范不回包。
tools/list、tools/call 原样转发到 127.0.0.1:8080，result 与顶层 error 忠实透传，
仅把 id 改写回客户端原始 id。
并发：读线程即时应答 initialize/ping，单工作线程串行转发工具调用（保证顺序、
慢工具不阻塞 ping）。
stdout 只走 sys.stdout.buffer 并加锁，规避 Windows 的 \n→\r\n 翻译；
诊断信息一律走 stderr。
CAD 未启动时桥照常启动，工具调用回 -32603（可重试）。
入口：python -m mcp_bridge，支持 --host/--port/--timeout/--verbose/--print-config。

dwg_review/mcp_client.py 增加 raw_rpc()（_rpc 新增 normalize 开关），
返回基座原始响应 dict 供桥透传，避免重复实现 TCP 封装。

验证：

verify_stdio_bridge.py 24/24 PASS（版本协商、通知不回包、ping、tools/list 与基座
等价、tools/call、错误透传、-32700、string id、stdout 纯净性、死端口降级）。
真实标准客户端 MCP Inspector 冒烟通过：tools/list 拿到 26 个工具，
tools/list --strict 退出码 0（无 schema 可移植性问题），
tools/call get_drawing_info 返回标准 content + isError:false。
回归：verify_mcp_frame.py 4/4、verify_annotate.py 9/9、dwg_review --list-tools/--check 正常。

标准 MCP 客户端（Claude Desktop / CodeBuddy / MCP Inspector）只实现 stdio 与 Streamable HTTP，无法直连 cad_mcp_frame 的自定义裸 TCP。新增 mcp_bridge 包在客户端与基座之间做协议适配，CAD 侧零改动： - 合成基座缺失的生命周期：initialize（含协议版本协商、capabilities、serverInfo）与 ping；notifications/* 按规范不回包。 - tools/list、tools/call 原样转发到 127.0.0.1:8080，result 与顶层 error 忠实透传，仅把 id 改写回客户端原始 id。 - 并发：读线程即时应答 initialize/ping，单工作线程串行转发工具调用（保证顺序、慢工具不阻塞 ping）。 - stdout 只走 sys.stdout.buffer 并加锁，规避 Windows 的 \n→\r\n 翻译；诊断信息一律走 stderr。 - CAD 未启动时桥照常启动，工具调用回 -32603（可重试）。 - 入口：python -m mcp_bridge，支持 --host/--port/--timeout/--verbose/--print-config。 dwg_review/mcp_client.py 增加 raw_rpc()（_rpc 新增 normalize 开关），返回基座原始响应 dict 供桥透传，避免重复实现 TCP 封装。验证： - verify_stdio_bridge.py 24/24 PASS（版本协商、通知不回包、ping、tools/list 与基座等价、tools/call、错误透传、-32700、string id、stdout 纯净性、死端口降级）。 - 真实标准客户端 MCP Inspector 冒烟通过：tools/list 拿到 26 个工具， tools/list --strict 退出码 0（无 schema 可移植性问题）， tools/call get_drawing_info 返回标准 content + isError:false。 - 回归：verify_mcp_frame.py 4/4、verify_annotate.py 9/9、dwg_review --list-tools/--check 正常。

home-Lenovo-Legion-r9000 added 1 commit 2026-10-14 00:44:23 +08:00

feat(bridge): 新增 stdio↔TCP 桥，让标准 MCP 客户端可直连 CAD 基座 f33d42afe9

标准 MCP 客户端（Claude Desktop / CodeBuddy / MCP Inspector）只实现 stdio 与
Streamable HTTP，无法直连 cad_mcp_frame 的自定义裸 TCP。新增 mcp_bridge 包在
客户端与基座之间做协议适配，CAD 侧零改动：

- 合成基座缺失的生命周期：initialize（含协议版本协商、capabilities、serverInfo）
  与 ping；notifications/* 按规范不回包。
- tools/list、tools/call 原样转发到 127.0.0.1:8080，result 与顶层 error 忠实透传，
  仅把 id 改写回客户端原始 id。
- 并发：读线程即时应答 initialize/ping，单工作线程串行转发工具调用（保证顺序、
  慢工具不阻塞 ping）。
- stdout 只走 sys.stdout.buffer 并加锁，规避 Windows 的 \n→\r\n 翻译；
  诊断信息一律走 stderr。
- CAD 未启动时桥照常启动，工具调用回 -32603（可重试）。
- 入口：python -m mcp_bridge，支持 --host/--port/--timeout/--verbose/--print-config。

dwg_review/mcp_client.py 增加 raw_rpc()（_rpc 新增 normalize 开关），
返回基座原始响应 dict 供桥透传，避免重复实现 TCP 封装。

验证：
- verify_stdio_bridge.py 24/24 PASS（版本协商、通知不回包、ping、tools/list 与基座
  等价、tools/call、错误透传、-32700、string id、stdout 纯净性、死端口降级）。
- 真实标准客户端 MCP Inspector 冒烟通过：tools/list 拿到 26 个工具，
  tools/list --strict 退出码 0（无 schema 可移植性问题），
  tools/call get_drawing_info 返回标准 content + isError:false。
- 回归：verify_mcp_frame.py 4/4、verify_annotate.py 9/9、dwg_review --list-tools/--check 正常。

home-Lenovo-Legion-r9000 added 1 commit 2026-10-14 06:21:53 +08:00

fix(frame): 未知工具错误码 -32601 改为 -32602，符合 MCP 规范 3bd77d950e

MCP 规范《Tools / Error Handling》把「未知工具」归为**协议错误**，
示例即为 {"code": -32602, "message": "Unknown tool: invalid_tool_name"}。
基座原先回 -32601（Method not found），语义偏 JSON-RPC 方法层。

- mcp_configParser.cpp: mcp_Tools::Call 改 -32601 → -32602，
  消息改为 "Unknown tool: <name>"。
- 无需改 mcp_server.cpp 的 HandleToolsCall：其协议错误白名单
  {-32700,-32600,-32601,-32602} 已含 -32602，分类逻辑不变。
- 同步更新 verify_mcp_frame.py 与 verify_stdio_bridge.py 的断言
  （未知「方法」仍是 -32601，语义正确，不动）。

验证（重建基座 + 重启 CAD 后实测）：
- 直连 TCP：{"error":{"code":-32602,"message":"Unknown tool: __no_such_tool__"}}
- verify_mcp_frame.py 4/4 PASS；verify_stdio_bridge.py 24/24 PASS
- 回归：verify_annotate.py 9/9、dwg_review --check 正常
- MCP Inspector 冒烟：tools/list 26 个工具、tools/call get_drawing_info 正常

gjm merged commit 4ab591ad23 into main

2026-10-14 13:33:35 +08:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: gjm/cad-agent#8