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 的回答
—
3. 这三个数就是全部故事
- 截断 → E010。补全会发明内容;
agent/ execution 档不允许,返回lossy_repair,executable: false。 - 重试提示是 API 的一部分。
retry.prompt带位置、原因、片段,模型可以直接照着改。 - 重发 → 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)。