大家好。今天我们将继续探索 Claude Code 的主要源码。

但你有没有想过一个单机版的 AI 编程助手。怎么能随心所欲地去查天气、读内部数据库，甚至和公司的专属 API 打交道呢？

今天我们就来揭开让 Claude Code 拥有无限 能力的终极武器——MCP 服务与插件整体环境。

学习目标

学习完这章后你会对下面内容有清晰的认识：

1. 理解 MCP 的架构原理与通信机制。不过，
2. 掌握 Claude Code 插件整体环境的设计。还有它与 MCP 的关系。
4. 能够亲手编写并集成一个自定义的 MCP 插件。

至于理论讲解，为什么需要 MCP 与插件程序？

在看这部分源码之前。我一直有个疑问：如果我想让 Claude Code 能查天气、读数据库或者调公司内部的 API，直接在源码里加几个新的 Tool 不就好了吗？

直到我翻开源码，看到 Anthropic 提出的 MCP 还有建立在其上的 插件程序 时我才恍然大悟——人家的格局大多了。

内置的 Tool是硬编码在代码里的。采用 TypeScript 编写，和主要引擎深度绑定。怎么说呢，但如果我们希望接入百花齐放的外部能力。这种紧耦合的模式显然行不通。

MCP 就像是 AI 时代的 USB 接口，而插件则是封装好的 U 盘。

MCP 是一种标准化的通信协议，允许 Claude Code与本地或远程的服务器进行交互。通过这个接口，你可以让 Claude Code 获得：

1. 工具暴露可执行的函数供模型调用。
2. 资源暴露静态的上下文数据。
3. 提示词模板提供预定义的 Prompt 模板。说起来，

而插件程序则是为了让使用者能更方便地分发和安装这些 MCP 服务。在 Claude Code 中，你可以通过 /plugin 命令直接从插件行业市场下载别人写好的插件包。这些插件底层往往就是一个或多个 MCP Server。怎么说呢，

最棒的是由于它是跨进程的。你可以用 Python、Go、Rust 任何你喜欢的语言来写插件，彻底打破了环境的壁垒。

源码分析这方面，解密插件加载与 MCP 通信

. 插件环境与配置加载

在源码的 src/utils/plugins/ 目录下我看到了完整的插件生命周期管理。一个标准的 Claude Code 插件通常包含一个 manifest.json里面声明了它提供的能力。更硬核的是为了方便分发，源码还支持一种叫做 MCPB 的格式。

在 src/utils/plugins/mcpPluginIntegration.ts 中，loadPluginMcpServers 函数展示了插件加载的优先级：

1. 解析插件目录下的 .mcp.json。
2. 解析 manifest.json 中的 mcpServers 字段。
3. 如果配置的是一个 .mcpb 压缩包。它会调用 loadMcpbFile 自动下载、解压缓存，甚至还能处理需要使用者填写的鉴权配置。

最终在 src/services/mcp/config.ts 中。Claude Code 会把这些插件提供的 MCP 服务，与使用者全局或项目目录下手动配置的 .claude/settings.json 进行合并。不过，这种多层级的配置聚合，保证了灵活性的也兼顾了项目的隔离。

. 通信枢纽

拿到所有配置后就该建立连接了。翻开 client.ts，这个是我在源码里看到的最硬核的设计之一。

Claude Code 支持了多种传输层协议，包括 **stdio**、**SSE** 和 **HTTP**。其中我们平时写本地插件最常用到的就是 `stdio`。

// src/services/mcp/client.ts transport = new StdioClientTransport。...serverRef.env,},stderr: 'pipe',// 防止插件的报错直接污染使用者的 UI 界面})

**这里有个非常高明的设计理念：进程隔离。**你的 MCP Server 是作为一个独立的子进程被拉起的。Claude Code 通过标准输入输出来发送和接收 JSON-RPC 信息。这代表着什么，这代表着就算你下载的第三方插件代码写得稀烂。运行时直接崩溃了主进程依然稳如泰山，仅仅是那个插件不可用而已。怎么说呢，

. 透明代理

当 MCP Server 连接上后。它暴露出来的工具是怎么让大模型看到的呢？大模型能区分哪个是内置工具，哪个是远端插件工具吗？

说到答案是，完全区分不出来。

在 MCPTool.ts 中，源码使用了一个非常优雅的“代理”模式。把远端工具包装成了本地标准格式：// src/tools/MCPTool/MCPTool.tsexport const MCPTool = buildTool

// src/tools/* *s const buildTool = => { const { isMcp,name,maxResultSizeChars } = options;return { async call { // TODO: 实现真正的调用逻辑 return { content: };},name,maxResultSizeChars,};}，// src /tools /tools /tools /tools /tools /tools /tools *s const buildTool = => { const { isMcp,name } = options;return { async call { // TODO: 实现真正的调用逻辑 return {};},name,}，};export default buildTool;export const mcpTool = buildTool //export const mcpTools =;import mcpp from './tool';
export default function buildtool{ return options;} export const toolName= ‘wear’ import React from ‘react’;export default function Tool{ return null;} import Weartool from './tool';export default toolName;import Wear toolName={ wear} export const getwear= async =>{ console .log ’);} import Weartool from './tool';import Weartool from './Wear tool’ import Wear toolName={ wear} import Weartool from './tool';import Weartool from './Wear tool’ export const getwear= async =>{ console .log ’);} import Weartool from './tool';import Wear toolName={ wear} import Weartool from './tool';话说回来，import Weartool from './Wear tool’ export const get_wear= async =>{ console .log;} import Weartool from './tool';import Wear toolName={ wear} import Weartool from './tool';import Wear toolName={ wear} import Weartool from './tool';import Wear toolName={ wear} import Wear toolName={ wear} export default function createMock {} });//使用方法var mock={} var result=mock );)，);)，);)，);)，);)，);)，});)，});)，};]，);}，];)，};]，);}，];)，};]，);}，];)，};]，);}，];)，};]]，]];]]，]];]]，]];]]，]];]]，]];]]，}];})，

结合 // src tools / tools tools tools tools tools tools tools tools tools */s const buildTool = => { const { isMcp,name } = options;return { async call { // TODO: 实现真正的调用逻辑 return {};},name,}，};export default buildTool;export const mcpTool = buildTool //export const mcpTools =;import mcpp from './tool';export default function buildtool{ return options;不过，} export const toolName= ‘wear’ import React from ‘react’;export default function Tool{ return null;} import Weartool from './tool';export default toolName;import Wear toolName={ wear} export const getwear= async =>{ console .log ’);} import Weartool from './tool';import Weartool from './Wear tool’ import Wear toolName={ wear} import Weartool from './tool';import Wear toolName={ wear} import Weartooolfrom;imporrt Weartooolfrom.’./stool’. export consut getweater= asyn =>{ console .log );} imort Weartooolfrom.’./stool’. //export Default function creatMock{}

本技术文章仅供学习交流之用。

再看动手实践，写一个天气查询插件

第一步先：编写 MCP Server脚本