MCP 协议集成

Model Context Protocol (MCP) 让 Claude Code 可以连接外部工具服务器 — 将任意工具、资源和 prompt 模板无缝集成到对话中。

MCP 概览

MCP 是 Anthropic 提出的标准协议，用于连接 AI 模型和外部工具/数据源。Claude Code 作为 MCP Client，可以连接多个 MCP Server。

集成架构

MCP 集成涉及以下关键组件：

• MCP Client 管理 — AppState 中维护 mcpClients 列表，每个连接对应一个 MCP Server
• 工具注入 — MCP Server 提供的工具以 mcp__{server}__{tool} 前缀注入到工具池
• 资源访问 — 通过 ListMcpResourcesTool 和 ReadMcpResourceTool 读取 MCP 资源
• MCPTool 代理 — 通用工具代理，透传执行任意 MCP 工具

MCP 工具代理

MCP Server 提供的工具通过 MCPTool 代理执行：

// MCP 工具命名约定
mcp__github__create_pr      // server: github, tool: create_pr
mcp__database__query         // server: database, tool: query
mcp__slack__send_message     // server: slack, tool: send_message

// MCPTool 执行流程
class MCPTool {
  // 开放式输入 schema — 透传 MCP 工具的参数
  inputSchema: 'passthrough'

  async call(input, context) {
    // 1. 工具名和参数在运行时覆盖
    const result = await mcpClient.callTool(toolName, input);
    // 2. 返回执行结果
    return result;
  }
}
    

权限处理

MCP 工具的权限通过通配符匹配：

// 权限规则示例
{ toolName: 'mcp__github__*' }          // 允许 github server 的所有工具
{ toolName: 'mcp__database__query' }     // 仅允许 database 的 query 工具
    

资源系统

MCP Server 生命周期