插件管理协议服务器

用于访问Claude Code插件的MCP服务器,提供插件列表和详细信息的检索功能,适用于AI工具集成和开发环境。

  • by ppspps824
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 ppspps824/cc-plugin-mcp

使用说明

cc插件mcp

MCP(模型上下文协议)服务器,用于访问Claude Code插件。

概述

此MCP服务器通过模型上下文协议提供与Claude Code插件系统的接口,使您能够检索插件列表和详细信息。它可以从MCP客户端使用,如Claude Desktop、Cursor等。

主要特点

  • MCP协议支持:符合模型上下文协议
  • 插件管理:检索插件列表并从Claude Code插件加载元素
  • 安全:路径遍历保护、输入验证、错误处理
  • 演出:LRU缓存用于快速访问
  • 可操作性:全面的日志记录,29个测试用例

MCP工具

  • list_plugins -获取可用插件列表
  • load_elements -从指定插件加载元素(技能、代理、命令)

配置

将以下内容添加到MCP客户端配置文件中(例如。, claude_desktop_config.json 克劳德桌面版):

{
  "mcpServers": {
    "cc-plugin-mcp": {
      "command": "uvx",
      "args": ["cc-plugin-mcp"]
    }
  }
}

安装

# Run directly with uvx (recommended)
uvx cc-plugin-mcp

# Or install from PyPI
pip install cc-plugin-mcp

# For development
git clone https://github.com/ppspps824/cc-plugin-mcp.git
cd cc-plugin-mcp
uv sync --all-extras

用法

它作为MCP服务器运行,由MCP客户端直接调用。对于手动测试:

# Start MCP server with uvx (recommended)
uvx cc-plugin-mcp

# Or for development
uv run python -m cc_plugin_mcp.main

MCP与AI工具的集成

为了优化此MCP服务器与Cursor、Claude Desktop或其他MCP兼容客户端等AI工具的使用:

带光标

  1. 将MCP服务器添加到光标设置中(.cursor/settings.json 或类似)
  2. 包括上述配置部分所示的配置
  3. 重要:确保在系统提示或初始消息中加载MCP服务器工具。通过指示AI首先调用MCP工具列表来发现可用的工具,告诉AI使用可用的MCP工具。

使用克劳德桌面

  1. 将配置添加到 claude_desktop_config.json 如配置部分所示
  2. 重新启动Claude Desktop以启用MCP服务器
  3. MCP工具将自动供Claude使用

使用MCP工具的最佳实践

  • 先装载工具:始终指示AI首先调用可用的MCP工具,以发现可用的工具
  • 检查系统提示:确保您的系统提示或初始说明包括使用MCP工具的指导
  • 发现功能:在请求特定功能之前,使用工具探索可用的插件及其元素

测试

# Run tests
uv run pytest

# With coverage
uv run pytest --cov=cc_plugin_mcp

故障排除

未找到插件

  1. 检查是否 ~/.claude/plugins/ 目录存在
  2. 验证 marketplace.json 存在于 ~/.claude/plugins/marketplaces/

MCP客户端无法识别服务器

  1. 验证MCP客户端配置文件是否设置正确
  2. 检查是否 uvx 命令可用(uvx --version)
  3. 检查MCP客户端日志中的错误消息

测试失败

uv sync --all-extras --refresh
uv run pytest -v

许可证

麻省理工学院

仓库

https://github.com/ppspps824/cc-plugin-mcp