LIWENJSON × MCP — 执行门接入

MCP 让 agent 发现工具;真正的价值是宿主在执行工具参数之前过闸。 liwenjson_gate 返回 executable;为 false 时把 retry.prompt 原样回灌模型。服务本地运行、只读、无网络。

1. 一行配置

Claude Code

claude mcp add liwenjson -- liwenjson mcp

mcp.json(Cursor / Cline / Windsurf 等)

{"mcpServers":{"liwenjson":{"command":"liwenjson","args":["mcp"]}}}

装 pip 包时命令是 liwenjson-mcp(它解析二进制并替换进程); npm 包 liwenjson 的 bin 也是 liwenjson-mcp, 需要本机原生可执行文件。四个工具:liwenjson_gate(主入口,默认 agent 档) / liwenjson_repair / liwenjson_validate / liwenjson_readiness, 每个都只读。结果分两条通道:content[0].text 是给模型的摘要(判定、 executable、以及拒绝时要回灌的句子),structuredContent 是完整载荷。不可执行时一定带非空的 retry.prompt,且 value 为 null —— 门拒绝的值不会同时递给调用方。

不想记命令:liwenjson mcp --print-config=claude 直接打印上面那行, --print-config=json 打印 mcpServers 片段;另外支持 cursor / vscode / codex / windsurf / zed。

2. 模型给出坏参数,门怎么回答

模型输出(被 max_tokens 截断)

schema 就是工具已有的 inputSchema;这里用 JSON Schema 子集直接传给 liwenjson_gate,档位用默认的 agent。

liwenjson_gate 的回答

decision— executable— exactness— error— schema—
—

3. 这三个数就是全部故事

  1. 截断 → E010。补全会发明内容;agent / execution 档不允许,返回 lossy_repair,executable: false。
  2. 重试提示是 API 的一部分。retry.prompt 带位置、原因、片段,模型可以直接照着改。
  3. 重发 → safe。同一份声明、同一个调用;这次 executable: true,宿主才执行。

4. 会话实录

→ tools/call  liwenjson_gate
← decision: lossy_repair      executable: false
  error: E010  CloseContainer at 1:31
  retry: "LIWENJSON refused the arguments: E010 ..."

→ tools/call  liwenjson_gate
← decision: safe              executable: true
OK  execute create_invoice({"amount":100,"currency":"USD"})

上面按当前工具名重写;那次真实会话的原始记录在 mcp-claude/ 与 mcp-claude-session.txt, 录制于更名之前、是不可改写的逐字节证据,因此保留旧服务名与旧工具名 (现在的 liwenjson_gate 当时叫 *_analyze)。