MCP & Web Tools

问题

Agent 的能力不该止步于本地。现实世界在 Agent 之外：

• 一个记忆系统、一个数据库服务、一个内部 API——它们各有各的协议；
• 互联网搜索、网页抓取——模型训练数据里没有今天的信息。

外部世界成为工具，需要两种桥：一是标准协议桥（MCP：Model Context Protocol——外部服务器暴露工具，harness 发现并注册），二是能力缝桥（web 搜索/抓取，提供者可换）。

解决方案

第 1 类：MCP 客户端——连接一个 MCP 服务器，发现它的工具，注册进本地注册表：

// 连接 MCP 服务器（stdio 或 HTTP），发现工具
async function connectMcpServer(name, transport) {
  const client = await mcpConnect(transport);       // 启动/连接服务器
  const { tools } = await client.listTools();       // 发现工具
  for (const t of tools) {
    define(`mcp__${name}__${t.name}`, t.inputSchema, async (args) => {
      const r = await client.callTool(t.name, args); // 转发调用
      return formatMcpResult(r);
    });
  }
  return `已注册 ${tools.length} 个工具`;
}

第 2 类：Web 能力缝——搜索与抓取走同一套提供者接口：

// ctx.web 缝：注册搜索提供者
registerWebProvider("search", { name: "deepseek", async search(q) { /* ... */ } });
registerWebProvider("search", { name: "exa",      async search(q) { /* ... */ } });
registerWebProvider("fetch",  { name: "http",     async fetch(url) { /* ... */ } });

define("web_search", { type: "object", properties: { query: { type: "string" } }, required: ["query"] },
  async ({ query }) => await webSearch(query)); // 按配置选择提供者

define("web_fetch", { type: "object", properties: { url: { type: "string" } }, required: ["url"] },
  async ({ url }) => await webFetch(url));

工作原理

第 1 步：MCP 工具命名带服务器前缀（mcp__server__tool），避免不同服务器的同名工具冲突；stdio 服务器的生命周期挂在 harness 插件生命周期上（启动/停止跟随插件）。

第 2 步：web 缝的搜索与抓取共享提供者选择服务——选一个搜索后端（DeepSeek/Exa/Perplexity）、一个抓取后端（HTTP），工具描述不变，后端可换（s17 的哲学再次出现）。

第 3 步：外部工具的返回要规整成文本（或结构化 JSON）——工具结果的形态决定模型消费的难易。MCP 结果、搜索摘要、页面正文，最终都变成模型能读的字符串。

试一下

运行 s19：

• 用一个本地 MCP 服务器（stdio），让模型调用它暴露的工具
• 用 web_search 问一个需要实时信息的问题（"今天 DeepSeek 发布了什么"）
• 用 web_fetch 抓一个 URL 并让模型总结

观察重点：外部工具的延迟与失败——MCP 服务器挂了会怎样？搜索超时了会怎样？（答案：进入 s11 的错误恢复与超时策略。）