Plugins can bundle MCP servers, automatically providing tools and integrations when the plugin is enabled. Plugin MCP servers work identically to user-configured servers. 插件可以捆绑 MCP 服务器,在插件启用时自动提供工具和集成。插件 MCP 服务器与用户配置的服务器工作方式完全相同。
1, How plugin MCP servers work: 插件 MCP 服务器的工作原理:
Plugins define MCP servers in .mcp.json at the plugin root or inline in plugin.json 插件在插件根目录的 .mcp.json 处定义 MCP 服务器或直接在 plugin.json 处定义
When a plugin is enabled, its MCP servers start automatically 当插件启用时,其 MCP 服务器将自动启动
Plugin MCP tools appear alongside manually configured MCP tools 插件 MCP 工具与手动配置的 MCP 工具并列出现
Plugin servers are managed through plugin installation (not /mcp commands) 插件服务器通过插件安装进行管理(不是 /mcp 命令)
2,Example plugin MCP configuration: 插件 MCP 示例配置:
In .mcp.json at plugin root: 在插件根目录下的.mcp.json:
{
"database-tools": {
"command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
"args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"],
"env": {
"DB_URL": "${DB_URL}"
}
}
}
Or inline in plugin.json: 或直接在 plugin.json 中:
{
"name": "my-plugin",
"mcpServers": {
"plugin-api": {
"command": "${CLAUDE_PLUGIN_ROOT}/servers/api-server",
"args": ["--port", "8080"]
}
}
}
3,Plugin MCP features: 插件 MCP 功能:
Automatic lifecycle: Servers start when plugin enables, but you must restart Claude Code to apply MCP server changes (enabling or disabling) 自动生命周期:插件启用时服务器启动,但您必须重启 Claude Code 才能应用 MCP 服务器更改(启用或禁用)
Environment variables: Use {CLAUDE_PLUGIN_ROOT} 表示插件相对路径
User environment access: Access to same environment variables as manually configured servers 用户环境访问:可访问与手动配置的服务器相同的环境变量
Multiple transport types: Support stdio, SSE, and HTTP transports (transport support may vary by server) 多种传输类型:支持 stdio、SSE 和 HTTP 传输(传输支持可能因服务器而异)
4,Viewing plugin MCP servers: 查看插件 MCP 服务器:
# Within Claude Code, see all MCP servers including plugin ones
/mcp
Plugin servers appear in the list with indicators showing they come from plugins. 插件服务器会出现在列表中,并有指示器显示它们来自插件。
5,Benefits of plugin MCP servers: 插件 MCP 服务器的优势:
Bundled distribution: Tools and servers packaged together 捆绑分发:工具和服务器打包在一起
Automatic setup: No manual MCP configuration needed 自动设置:无需手动配置 MCP
Team consistency: Everyone gets the same tools when plugin is installed 团队一致性:插件安装后,每个人都会获得相同的工具