插件开发

为 Claude Code 创建自定义插件的详细指南——扩展工具和能力。

插件架构

Claude Code 支持多种扩展方式：

• MCP 服务器：通过 Model Context Protocol 连接外部服务
• 自定义工具：使用 Agent SDK 构建的工具
• 技能：通过指令集扩展工作流

创建 MCP 服务器

基础结构

MCP 服务器是一个独立运行的进程，通过标准输入/输出与 Claude 通信：

// 使用 @modelcontextprotocol/sdk
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";

const server = new McpServer({
  name: "my-plugin",
  version: "1.0.0"
});

// 注册工具
server.tool("search-docs", { query: z.string() }, async ({ query }) => {
  const results = await searchDocumentation(query);
  return { content: [{ type: "text", text: results }] };
});

// 启动服务器
const transport = new StdioServerTransport();
await server.connect(transport);

注册工具

每个工具需要定义：

• 名称：工具的标识符
• 描述：工具的功能说明
• 输入 Schema：使用 JSON Schema 定义参数
• 处理函数：执行工具逻辑并返回结果

配置

在 .claude/mcp.json 中配置启动方式：

{
  "mcpServers": {
    "my-plugin": {
      "command": "node",
      "args": ["/path/to/my-plugin/server.js"]
    }
  }
}

创建自定义工具（Agent SDK）

使用 Agent SDK 可以构建更复杂的工具：

from anthropic import Anthropic
from claude_code_sdk import Tool, ClaudeCode

class MyCustomTool(Tool):
    name = "search_database"
    description = "搜索项目数据库中的记录"

    def execute(self, **kwargs):
        # 实现工具逻辑
        return search_db(kwargs["query"])

cc = ClaudeCode(tools=[MyCustomTool()])

发布插件

• 将 MCP 服务器发布为 npm 包
• 创建技能文件并分享到社区
• 编写文档和使用示例

最佳实践

• 保持工具专注：每个工具做一件事并做好
• 清晰的描述：帮助 Claude 理解何时使用工具
• 错误处理：返回清晰的错误信息
• 安全考虑：不要暴露敏感操作

下一步

• 发现与安装插件
• MCP 协议集成
• Agent SDK 自定义工具