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