MCP（Model Context Protocol，模型上下文协议）是一个开放标准，让 AI 应用能"即插即用"地接入外部工具和数据源。你写一个 MCP server（比如封装公司内部 API），任何支持 MCP 的客户端（Claude Code、Cursor…）都能连上、用它的工具——不用改客户端代码。

核心代码：客户端库 packages/mcp-client/、宿主集成 src/services/mcp/。

Claude Code 在 MCP 里有两个身份，别搞混：

"传输（transport）"= Claude Code 和 MCP server 之间怎么通信。真实的类型枚举（src/services/mcp/types.ts:23）：

export const TransportSchema = lazySchema(() =>
  z.enum(['stdio', 'sse', 'sse-ide', 'http', 'ws', 'sdk', 'claudeai-proxy']),
)

// stdio 型服务器的配置（最常用）：
export const McpStdioServerConfigSchema = lazySchema(() =>
  z.object({
    type: z.literal('stdio').optional(),   // 可省略（默认 stdio）
    command: z.string().min(1),            // 启动命令
    args: z.array(z.string()).default([]), // 命令参数
    env: z.record(z.string(), z.string()).optional(),  // 环境变量
  }),
)

建连在 src/services/mcp/client.ts（真实 import）：StdioClientTransport / SSEClientTransport / StreamableHTTPClientTransport / WebSocketTransport，不支持的 type 抛 "Unsupported server type"。

项目级配置文件是仓库根的 .mcp.json。一个典型配置：

{
  "mcpServers": {
    "my-db": {                              // 服务器名
      "command": "npx",                     // stdio: 启动命令（对应 L03 schema）
      "args": ["-y", "my-db-mcp-server"],
      "env": { "DB_URL": "..." }
    },
    "internal-api": {
      "type": "http",                       // http 型
      "url": "https://mcp.mycompany.com"
    }
  }
}

读取支持四个作用域——project（.mcp.json）/ user / local / enterprise（企业锁定）。getAllMcpConfigs 汇总所有来源 + 插件提供的 server。

连上 server 后怎么知道它有哪些工具？discoverTools（packages/mcp-client/src/discovery.ts:47）。这段真实代码是本页精华——它把每个 MCP 工具映射成 Day 07 的 CoreTool：

const result = await client.request({ method: 'tools/list' }, ...)  // ① 问它有啥工具
return result.tools.map((tool): CoreTool => {
  const fullyQualifiedName = buildMcpToolName(serverName, tool.name)  // ② 加 mcp__ 前缀
  return {
    name: skipPrefix ? tool.name : fullyQualifiedName,
    isMcp: true,
    inputJSONSchema: tool.inputSchema,           // ③ 直接用它原始 JSON Schema（不 zod 转）
    async prompt() { return tool.description ?? '' },  // ④ 给模型看的说明（Day 07 L07）
    isReadOnly: () => tool.annotations?.readOnlyHint ?? false,       // ⑤ 注解 → 行为标志
    isConcurrencySafe: () => tool.annotations?.readOnlyHint ?? false,
    isDestructive: () => tool.annotations?.destructiveHint ?? false,
    async checkPermissions() { return { behavior: 'passthrough' } },  // ⑥ 权限弃权，交给通用系统
  }
})

MCP 工具怎么和内置工具一起给模型？回忆 Day 07 的 assembleToolPool——它就是干这个的：

// 内置工具 + MCP 工具 合并、去重、按名排序（Day 07 讲的缓存稳定）
assembleToolPool(toolPermissionContext, mcpTools)

外部 MCP server 可能崩、可能断网。packages/mcp-client/src/connection.ts 做了不少韧性处理：

• 连接超时（默认 30s）——连不上不无限等。
• 断线监控 + 重连：连续 3 次终止性错误就触发重连。
• 进程清理升级：关 stdio 子进程时 SIGINT → SIGTERM → SIGKILL 逐级升压，确保进程真被杀掉。

✋ 动手：对着真实代码读一遍

# 1. 传输枚举 + stdio 配置 schema（L03）
sed -n '23,35p' src/services/mcp/types.ts

# 2. 工具发现映射成 CoreTool（L05，本页精华）
sed -n '47,92p' packages/mcp-client/src/discovery.ts

# 3. 建连的各种 transport（L03）
grep -n "ClientTransport\|Unsupported server type" src/services/mcp/client.ts | head

# 4. 连接韧性（L07）
grep -n "Timeout\|reconnect\|SIGKILL\|MAX_ERRORS" packages/mcp-client/src/connection.ts | head