不改主循环，挂上外部工具：react-agent-mini 怎么接 MCP

先读概念篇推荐MCP 到底是什么六大能力每个讲清「怎么用」系列回顾主循环 · 代码库工具 · REPL · 项目上下文 · Skills · 权限 Write概念篇把 MCP 六大能力讲完了。本篇只谈一件事react-agent-mini 如何在不改query()的前提下把外部 stdio MCP Tools 接进 ReAct 循环。mini只实现了 Tools StdioResources / Prompts / Sampling 等见概念篇本仓库概念演示在examples/mcp-tour-server。mini 接的是哪一块概念篇里的能力 mini Tools ✅ 连接、发现、适配、门卫、转发 Resources ❌ Prompts ❌ Sampling / Roots / Elicitation ❌ 传输 ✅ 仅 stdio策略先打通「动态工具表」这条主干——和内置 Echo / Read 走同一条runToolUse。一张图看清链路.mcp.json配置连哪些 server用什么命令启动 ↓ loadMcpTools() → stdio 启动子进程 → list_tools ↓ adaptMcpTool()每个 MCP tool → 内部 Tool 形状 ↓ sessionTools() builtinEcho/Read/… mcp__* 工具 ↓ 模型 tool_use → runToolUse → 门卫第六篇→ 转发 call_tool ↓ tool_result 回注 → query() 继续对query()来说MCP 工具和普通 Read 没区别。变化只在启动接线和适配层。动手5 分钟接上计算器仓库示例examples/mcp-calc-server只暴露add/multiply。Step 0先确认 Server 能跑nodeexamples/mcp-calc-server/smoke.mjs期望tools: add, multiply add(17,25): {content:[{type:text,text:17 25 42}]}Step 1写配置cp.mcp.json.example .mcp.json{mcpServers:{calc:{command:node,args:[examples/mcp-calc-server/server.js]}}}字段含义calcserver id → 工具名前缀commandargs如何拉起 stdio Server无配置文件跳过 MCP零开销Step 2启动 Agentbun run devREPL 里问用计算器工具算一下 17 加 25必须调用 MCP 工具不要心算Step 3对照链路启动 → list_tools → 注册 mcp__calc__add / mcp__calc__multiply 模型 → tool_use mcp__calc__add { a: 17, b: 25 } 门卫 → Allow? (y/N) → y 转发 → call_tool → 17 25 42 → tool_result → 自然语言回答headlessALLOW_WRITE1bun run dev --用 mcp__calc__add 计算 1725Step 4自己加 subtract在server.js的 list / call 各加一项重启Agent不热重载再问「100 减 37」。实现要点工具名mcp__server__tool避免和内置Read/Write冲突mcp__calc__add模型看到的是全名适配层映射回 Server 原始名再call_tool。适配器伪装成内部TooladaptMcpTool做四件事起名、描述、宽松 Zod 出站 JSON Schema、call()转发 MCP。adaptMcpTool(calc,{name:add,description:...},callTool)// → { name: mcp__calc__add, call: () 转发 MCP, ... }之后与 Echo 同一条流水线查找 → 校验 →门卫→call→tool_result。权限复用第六篇门卫MCP 默认isReadOnly: false模式行为REPLy/Nheadless默认拒绝除非ALLOW_WRITE1readOnlyHint: true时映射为只读、自动放行。启动接线const[{systemPrompt,skills},mcp]awaitPromise.all([loadSessionContext(),loadMcpTools(),])consttoolssessionTools(mcp.tools)// …finally{awaitcloseMcp?.()}连接有超时list 15s、call 30s单个 server 失败则 stderr 警告并跳过。和主循环的关系L1 CLI → .mcp.json、合并 tools、门卫 L2 query() → 不变 L3 runToolUse → 不变 L4 适配 → services/mcp/MCP 不改变 ReAct 循环只改变「工具表从哪来」。刻意没做什么没做说明Resources / Prompts / …见概念篇 examples/mcp-tour-serverStreamable HTTP / OAuth仅本地 stdio热重载改配置需重启完整版 Claude Code / Cursor 会做全能力mini 验证的是配置 → 连接 → list_tools → 适配 Tool → 合并 → 复用 runToolUse系列拼图篇能力1–6循环 → 代码库 → REPL → 上下文 → Skills → 门卫7MCP 概念与六大能力 Demo8本篇mini 接线实现带走什么mini 只接Tools Stdio够理解「外挂设备」怎么进循环。适配器 门卫复用→ 下游零感知。想弄清 Resources / Prompts 等 → 回概念篇跑mcp-tour-server。仓库与链接GitHubreact-agent-mini概念篇mcp-concepts.md计算器接 Agentexamples/mcp-calc-server概念 tourexamples/mcp-tour-server配置模板.mcp.json.exampleMCP 规范欢迎 Star、Issue 和 PR。本文基于 react-agent-mini 变更v3-mcpstdio MCP 工具适配撰写。