cc-plugin-mcp 0.1.4

Claude Code Plugin MCP - Access Claude Code plugins via MCP protocol

cc-plugin-mcp

MCP (Model Context Protocol) server for accessing Claude Code plugins.

Overview

This MCP server provides an interface to Claude Code's plugin system via the Model Context Protocol, enabling you to retrieve plugin lists and detailed information. It can be used from MCP clients such as Claude Desktop, Cursor, etc.

Key Features

• MCP Protocol Support: Compliant with Model Context Protocol
• Plugin Management: Retrieve plugin lists and load elements from Claude Code plugins
• Security: Path traversal protection, input validation, error handling
• Performance: LRU cache for fast access
• Operability: Comprehensive logging, 29 test cases

MCP Tools

• get-plugin-list - Get a list of available plugins
• load-elements - Load elements (skills, agents, commands) from specified plugins

Configuration

Add the following to your MCP client configuration file (e.g., claude_desktop_config.json for Claude Desktop):

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

Installation

# 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

Usage

This runs as an MCP server and is called directly by MCP clients. For manual testing:

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

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

Testing

# Run tests
uv run pytest

# With coverage
uv run pytest --cov=cc_plugin_mcp

Troubleshooting

Plugins not found

1. Check if ~/.claude/plugins/ directory exists
2. Verify marketplace.json exists in ~/.claude/plugins/marketplaces/

MCP client doesn't recognize the server

1. Verify MCP client configuration file is set up correctly
2. Check if uvx command is available (uvx --version)
3. Check MCP client logs for error messages

Tests failing

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

License

MIT

Repository

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