cc-plugin-mcp 0.1.3

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

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）に以下を追加：

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

インストール

# 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クライアントから直接呼び出されます。手動でテストする場合：

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

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

テスト

# テスト実行
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クライアントのログでエラーメッセージを確認

テストが失敗する場合

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

ライセンス

MIT

リポジトリ

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