MCP Integration

# Claude Code 插件的 MCP 集成 ## 概述 模型上下文协议 (MCP) 使 Claude Code 插件能够通过提供结构化的工具访问来与外部服务和 API 集成。使用 MCP 集成可以将外部服务功能作为工具暴露在 Claude Code 中。 **关键能力：** - 连接到外部服务（数据库、API、文件系统） - 从单个服务提供 10+ 个相关工具 - 处理 OAuth 和复杂的身份验证流程 - 将 MCP 服务器与插件捆绑以实现自动设置 ## MCP 服务器配置方法 插件可以通过两种方式捆绑 MCP 服务器： ### 方法 1：专用的 .mcp.json（推荐） 在插件根目录创建 `.mcp.json`： { "database-tools": { "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server", "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"], "env": { "DB_URL": "${DB_URL}" } } } **优点：** - 关注点分离清晰 - 更易于维护 - 适合多个服务器 ### 方法 2：在 plugin.json 中内联 在 plugin.json 中添加 `mcpServers` 字段： { "name": "my-plugin", "version": "1.0.0", "mcpServers": { "plugin-api": { "command": "${CLAUDE_PLUGIN_ROOT}/servers/api-server", "args": ["--port", "8080"] } } } **优点：** - 单个配置文件 - 适合简单的单服务器插件 ## MCP 服务器类型 ### stdio (本地进程) 将本地 MCP 服务器作为子进程执行。最适合本地工具和自定义服务器。 **配置：** { "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/allowed/path"], "env": { "LOG_LEVEL": "debug" } } } **使用场景：** - 文件系统访问 - 本地数据库连接 - 自定义 MCP 服务器 - NPM 打包的 MCP 服务器 **进程管理：** - Claude Code 启动并管理该进程 - 通过 stdin/stdout 通信 - 在 Claude Code 退出时终止 ### SSE (服务器发送事件) 连接到支持 OAuth 的托管 MCP 服务器。最适合云服务。 **配置：** { "asana": { "type": "sse", "url": "https://mcp.asana.com/sse" } } **使用场景：** - 官方托管的 MCP 服务器（Asana, GitHub 等） - 具有 MCP 端点的云服务 - 基于 OAuth 的身份验证 - 无需本地安装 **身份验证：** - OAuth 流程自动处理 - 用户在首次使用时收到提示 - 令牌由 Claude Code 管理 ### HTTP (REST API) 连接到 RESTful MCP s