MCP Quickstart 源码解析:processQuery 如何完成 Claude Tool Calling

理解 Anthropic Tool Use 消息流

本文结合源码,分析 processQuery() 的完整执行流程,并解释 Anthropic Tool Use API 的消息模型。

核心职责

processQuery() 的职责可以概括为:

  1. 接收用户问题
  2. 发送给 Claude
  3. 处理 Claude 发起的 Tool Use
  4. 调用 MCP Tool
  5. 将工具结果返回给 Claude
  6. 获取最终答案

整个流程本质上是一个标准的 Tool Calling 循环。


第一步:用户发起请求

用户输入:

复制代码
北京天气怎么样?

客户端构造消息:

ini 复制代码
const messages = [
  {
    role: "user",
    content: "北京天气怎么样?"
  }
];

当前消息历史:

sql 复制代码
user
└─ 北京天气怎么样?

第二步:Claude 请求调用工具

客户端调用:

csharp 复制代码
const response = await anthropic.messages.create(...)

Claude 判断需要查询天气,因此返回:

json 复制代码
{
  "type": "tool_use",
  "id": "toolu_001",
  "name": "weather",
  "input": {
    "city": "北京"
  }
}

此时源码执行:

php 复制代码
messages.push({
  role: "assistant",
  content: response.content as ContentBlockParam[]
});

消息历史变为:

scss 复制代码
user
└─ 北京天气怎么样?

assistant
└─ tool_use(weather)

这里保存的是 Claude 的完整响应内容,而不仅仅是工具名称。


第三步:调用 MCP Tool

客户端根据 Tool Use 信息调用 MCP Server:

php 复制代码
const result = await this.mcp.callTool({
  name: "weather",
  arguments: {
    city: "北京"
  }
});

工具返回:

json 复制代码
{
  "temperature": 28,
  "condition": "Sunny"
}

第四步:构造 Tool Result

这是很多人最容易疑惑的地方。

源码会把工具执行结果作为新的消息加入:

php 复制代码
messages.push({
  role: "user",
  content: [
    {
      type: "tool_result",
      tool_use_id: content.id,
      content: result.content
    }
  ]
});

注意:

vbnet 复制代码
role: "user"

而不是:

vbnet 复制代码
role: "tool"

这是 Anthropic Tool Use API 的设计要求。

消息历史变为:

scss 复制代码
user
└─ 北京天气怎么样?

assistant
└─ tool_use(weather)

user
└─ tool_result(28°C Sunny)

第五步:获取最终答案

再次调用 Claude:

csharp 复制代码
const finalResponse =
  await anthropic.messages.create(...)

Claude 收到工具结果后生成最终回复:

复制代码
北京当前温度为 28°C,天气晴朗。

消息流最终变成:

scss 复制代码
user
assistant(tool_use)
user(tool_result)
assistant(final answer)

为什么 Tool Result 的 Role 是 User?

很多开发者接触 OpenAI API 后会习惯这种模式:

scss 复制代码
user
assistant(tool_call)
tool
assistant

而 Anthropic 的设计不同:

scss 复制代码
user
assistant(tool_use)
user(tool_result)
assistant

原因是 Anthropic 将工具结果视为"外部环境返回的信息",统一由 user 角色提交给模型。

因此 Tool Result 必须放在:

vbnet 复制代码
role: "user"

中,并使用:

bash 复制代码
type: "tool_result"

进行标识。


processQuery 的本质

从架构角度看,processQuery() 实现的是一个最基础的 Agent Loop:

sql 复制代码
User Query
    ↓
Claude
    ↓
Tool Use
    ↓
MCP Tool
    ↓
Tool Result
    ↓
Claude
    ↓
Final Answer

其中最关键的两步是:

php 复制代码
messages.push({
  role: "assistant",
  content: response.content
});

保存 Claude 的 Tool Use 请求。

以及:

php 复制代码
messages.push({
  role: "user",
  content: [{
    type: "tool_result",
    ...
  }]
});

将工具执行结果返回给 Claude。

理解这两个消息的作用后,整个 MCP Client 的执行流程就非常清晰了。

总结

processQuery() 遵循的是 Anthropic Tool Use 标准协议,其完整角色流为:

scss 复制代码
user
assistant(tool_use)
user(tool_result)
assistant(final answer)

与 OpenAI 的 tool 角色不同,Anthropic 将工具执行结果包装为 user + tool_result 消息重新提交给模型。理解这一点,是理解 MCP Client、Claude Tool Calling 以及后续 Agent 框架实现的关键基础。

源码:github.com/modelcontex...

相关推荐
ndz7 小时前
PixVerse 768 个官方特效模板:Playground 预览,再用 API 批量出视频
ai编程
LV技术派9 小时前
肝了一周,我把 Super Agent 的架构融入到了我的 AI Native 工作台中
aigc·ai编程
孟健11 小时前
用 unslop 拯救 AI 生成网页的塑料感,7 分钟重构落地实测
前端·人工智能·ai编程
工程小白菜14 小时前
ai-code-review 全链路:让 AI 来审 AI 的代码
ci/cd·ai编程
小虎AI生活15 小时前
8万星开源HyperFrames,我用WorkBuddy免费模型做了3条视频
aigc·ai编程
AI大模型-小华18 小时前
Codex 自动测试怎么用?从生成测试用例到修复失败用例
git·测试用例·ai编程·软件开发·codex·chatgpt pro·codex cli
huangfuyk19 小时前
前端融入/转后端避坑指南:AI 时代的安全边界、数据防线与实战细节
后端·ai编程
黎羽_19 小时前
Claude 免费号 7 天养号毕业全记录:54 轮对话、IP 预检与月度维护
claude·免费账号·muse·ai 养号
ZzT20 小时前
AI-SDLC 实践 06|开发阶段的知识库:Agent 写代码前该读哪些规则和业务知识
ai编程·claude
Bigger20 小时前
我扒了 GitHub Trending 前 20,8 个在做同一件事:给 Coding Agent 造基础设施
开源·github·ai编程