Metadata-Version: 2.4
Name: cc-plugin-mcp
Version: 0.1.3
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

Claude CodeプラグインにMCP（Model Context Protocol）経由でアクセスするためのMCPサーバーです。

## 概要

Claude CodeのプラグインシステムとのインタフェースをMCPプロトコルで提供し、プラグイン一覧の取得や詳細情報の参照を可能にします。MCPクライアント（Claude Desktop、Cursor等）から利用できます。

## 主な機能

- **MCPプロトコル対応**: Model Context Protocolに準拠したサーバー
- **プラグイン管理**: Claude Codeプラグインの一覧取得と要素読み込み
- **セキュリティ**: パストトラバーサル対策、入力検証、エラーハンドリング
- **パフォーマンス**: LRUキャッシュによる高速化
- **運用性**: 包括的なロギング、29個のテストケース

## MCP ツール

- `get-plugin-list` - 利用可能なプラグインの一覧を取得
- `load-elements` - 指定されたプラグインの要素（skills, agents, commands）を読み込み

## 設定方法

MCPクライアントの設定ファイル（例：Claude Desktopの`claude_desktop_config.json`）に以下を追加：

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

## インストール

```bash
# uvxで直接実行（推奨）
uvx cc-plugin-mcp

# またはPyPIからインストール
pip install cc-plugin-mcp

# 開発環境の場合
git clone https://github.com/ppspps824/cc-plugin-mcp.git
cd cc-plugin-mcp
uv sync --all-extras
```

## 使い方

MCPサーバーとして動作するため、MCPクライアントから直接呼び出されます。手動でテストする場合：

```bash
# uvxでMCPサーバーとして起動（推奨）
uvx cc-plugin-mcp

# または開発環境の場合
uv run python -m cc_plugin_mcp.main
```

## テスト

```bash
# テスト実行
uv run pytest

# カバレッジ付き
uv run pytest --cov=cc_plugin_mcp
```

## トラブルシューティング

### プラグインが見つからない場合
1. `~/.claude/plugins/` ディレクトリの存在確認
2. `~/.claude/plugins/marketplaces/` に marketplace.json があるか確認

### MCPクライアントで認識されない場合
1. MCPクライアントの設定ファイルが正しく設定されているか確認
2. `uvx`コマンドが利用可能か確認（`uvx --version`）
3. MCPクライアントのログでエラーメッセージを確認

### テストが失敗する場合
```bash
uv sync --all-extras --refresh
uv run pytest -v
```

## ライセンス

MIT

## リポジトリ

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