Metadata-Version: 2.4
Name: cc-plugin-mcp
Version: 0.1.4
Summary: Claude Code Plugin MCP - Access Claude Code plugins via MCP protocol
Project-URL: Homepage, https://github.com/ppspps824/cc-plugin-mcp
Project-URL: Repository, https://github.com/ppspps824/cc-plugin-mcp
Project-URL: Bug Tracker, https://github.com/ppspps824/cc-plugin-mcp/issues
Author-email: papasim824 <papasim824@gmail.com>
License: MIT
Requires-Python: >=3.11
Requires-Dist: fastapi>=0.115.0
Requires-Dist: fastmcp>=0.1.0
Requires-Dist: pydantic-settings>=2.0.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: uvicorn[standard]>=0.30.0
Provides-Extra: dev
Requires-Dist: httpx>=0.25.0; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.21.0; extra == 'dev'
Requires-Dist: pytest>=7.4.0; extra == 'dev'
Description-Content-Type: text/markdown

# 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):

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

## Installation

```bash
# 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:

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

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

## Testing

```bash
# 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
```bash
uv sync --all-extras --refresh
uv run pytest -v
```

## License

MIT

## Repository

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