Radicle MCP

🚀 Radicle + GitHub MCP Server

このModel Context Protocol (MCP)サーバーセットアップは、統一されたインターフェースを通じて、Radicle（ピアツーピアのコードコラボレーション）とGitHubの両方とやり取りするためのツールを提供します。

✨ 主な機能

このセットアップには2つのMCPサーバーが含まれています。

🌟 Radicle MCP Server (Python)

• リポジトリ管理：Radicleリポジトリの初期化、クローン、および検査
• 同期：Radicleネットワークとリポジトリを同期
• パッチとイシュー：パッチとイシューの一覧表示と管理
• ノード情報：ノードIDとリモート情報の取得
• ヘルプシステム：Radicleコマンドのドキュメントにアクセス
• 🔄 GitHub統合：GitHubとRadicle間のイシューとPRの双方向同期

🐙 GitHub MCP Server (公式)

• リポジトリ操作：GitHubリポジトリの作成、フォーク、クローン
• イシュー管理：GitHubイシューの作成、更新、および管理
• プルリクエスト：プルリクエストとレビューの管理
• ファイル操作：リポジトリファイルの読み取り、書き込み、および管理
• 検索：リポジトリ、イシュー、およびコードの検索
• ユーザー管理：ユーザーと組織情報の管理

🔗 GitHub ↔ Radicle同期

• 双方向イシュー同期：プラットフォーム間でイシューを自動的に同期
• 冪等操作：重複することなく複数回実行できる
• メタデータ保存：元の著者、リンク、およびタイムスタンプを維持
• マッピングデータベース：GitHubとRadicleのアイテム間の関係を追跡
• MCP統合：AIアシスタントツールとして利用可能

🛠️ 利用可能なツール

リポジトリ操作

• rad_init：新しいRadicleリポジトリを初期化
• rad_clone：RIDで既存のリポジトリをクローン
• rad_status：リポジトリの状態と情報を取得
• rad_sync：リポジトリをネットワークと同期
• rad_push：変更をネットワークにプッシュ

コラボレーション機能

• rad_patch_list：リポジトリ内のパッチ（プルリクエスト）を一覧表示
• rad_issue_list：リポジトリ内のイシューを一覧表示
• rad_remote_list：リポジトリのリモート/ノードを一覧表示

ノードとID

• rad_id：あなたのRadicleノードIDを取得
• rad_help：Radicleコマンドのヘルプを取得

📋 前提条件

1. Radicle CLI：radコマンドがインストールされ、PATHに含まれていることを確認してください。

   # Radicleのインストール（インストール手順はhttps://radicle.xyzを参照）
   curl -sSf https://install.radicle.xyz | sh
   

2. Deno：GitHub MCPサーバーを実行するために必要です。

   # Denoのインストール
   curl -fsSL https://deno.land/install.sh | sh
   

3. Python環境：MCPライブラリを含むPython 3.8以上が必要です。

   pip install mcp
   

4. GitHub個人アクセストークン：GitHub統合に必要です。

   • https://github.com/settings/tokensにアクセスします。
   • repo、issues、およびpull requestの権限を持つ新しいトークンを作成します。
   • 環境変数GITHUB_PERSONAL_ACCESS_TOKENとして設定します。

📦 インストール

1. このリポジトリをクローンします。
2. 依存関係をインストールします。

   pip install -e .
   

3. 公式のGitHub MCPサーバーをインストールします。

   deno install -g --name github-mcp npm:@modelcontextprotocol/server-github
   

4. セットアップスクリプトを実行します。

   python setup_mcp.py
   

💻 使用例

クイックセットアップ

# GitHubトークンを設定
export GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here

# セットアップスクリプトを実行
python setup_mcp.py

GitHub ↔ Radicle同期

# 同期接続性をテスト
python demo_sync.py

# テストイシューを作成（オプション）
python create_test_issue.py

# 完全同期を実行
python github_radicle_sync.py

# またはCLIインターフェースを使用
python sync_cli.py --repo owner/repo --dry-run
python sync_cli.py --repo owner/repo --issues-only

MCP統合

同期機能はMCPツールとして利用可能です。

• github_sync_test：接続性をテスト
• github_sync_issues：イシューのみを同期
• github_sync_full：完全な双方向同期

詳細な同期ドキュメントはSYNC_README.mdを参照してください。

スタンドアロンサーバーとして

# Radicle MCPサーバー
python -m radicle_mcp.server

# GitHub MCPサーバー
github-mcp

Claude Desktopとの統合

セットアップスクリプトは自動的に設定を作成します。あなたのclaude_desktop_config.jsonには以下が含まれます。

{
  "mcpServers": {
    "radicle-mcp": {
      "command": "/path/to/python",
      "args": ["-m", "radicle_mcp.server"]
    },
    "github-mcp": {
      "command": "/path/to/github-mcp",
      "args": [],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_PERSONAL_ACCESS_TOKEN}"
      }
    }
  }
}

VS Code統合

このプロジェクトには、MCPサーバーをデバッグするためのVS Code設定が含まれています。提供されているmcp.jsonファイルを使用して、互換性のあるMCPクライアントに接続します。

コマンド例

MCPクライアントに接続したら、自然言語を使用して両方のプラットフォームとやり取りできます。

基本的な使用法

# Radicle操作
- "Initialize a new Radicle repository called 'my-project'"
- "Clone the repository with RID rad:z2..."
- "Show me the current patches in this repository"
- "Sync this repository with the network"
- "What's my Radicle node ID?"

# GitHub操作
- "Create a new GitHub repository called 'awesome-project'"
- "List my recent GitHub repositories"
- "Create an issue titled 'Bug fix needed'"
- "Show me open pull requests in my repository"
- "Search for repositories related to 'machine learning'"

# クロスプラットフォームワークフロー
- "Publish this Radicle repository to GitHub"
- "Sync issues between Radicle and GitHub"
- "Compare this repository on both platforms"

🔧 開発

テストの実行

python -m pytest tests/

コードスタイル

black src/
flake8 src/

📁 プロジェクト構造

radicle-mcp/
├── src/radicle_mcp/
│   ├── __init__.py
│   └── server.py          # メインのMCPサーバー実装
├── .vscode/
│   └── mcp.json          # VS CodeのMCP設定
├── .github/
│   └── copilot-instructions.md
├── pyproject.toml        # プロジェクト設定
└── README.md

🤝 コントリビューション

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 変更を加えます。
4. 適用可能な場合はテストを追加します。
5. プルリクエストを送信します。

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

🔗 関連リンク

• Radicleドキュメント
• Model Context Protocol
• MCP Python SDK