Radicle + GitHub MCP Server

Radicle+GitHub MCP服务器

一种模型上下文协议（MCP）服务器设置，提供通过统一界面与Radical（对等代码协作）和GitHub进行交互的工具。

特性

此设置包括两个MCP服务器：

🌟 Radical MCP服务器（Python）

• 库管理：初始化、克隆和检查Radical存储库
• 同步：将存储库与Radical网络同步
• 补丁和问题：列出并管理补丁和问题
• 节点信息：获取节点ID和远程信息
• 帮助系统：访问Radical命令文档
• 🔄 GitHub集成：GitHub和Radical之间问题和PR的双向同步

🐙 GitHub MCP服务器（官方）

• 存储库操作：创建、分叉、克隆GitHub存储库
• 问题管理：创建、更新和管理GitHub问题
• 拉取请求：管理拉取请求和审核
• 文件操作：读取、写入和管理存储库文件
• 搜索：搜索存储库、问题和代码
• 用户管理：管理用户和组织信息

🔗 GitHub↔ Radical同步

• 双向问题同步：自动同步平台之间的问题
• 临时运营：可安全运行多次，无重复
• 元数据保存：维护原作者、链接和时间戳
• 地图数据库：跟踪GitHub和Radical项目之间的关系
• MCP集成：可用作人工智能辅助工具

可用工具

存储库操作

• rad_init：初始化新的Radical存储库
• rad_clone：通过RID克隆现有存储库
• rad_status：获取存储库状态和信息
• rad_sync：将存储库与网络同步
• rad_push：将更改推送到网络

协作功能

• rad_patch_list：在存储库中列出补丁（拉取请求）
• rad_issue_list：在存储库中列出问题
• rad_remote_list：列出存储库的远程/节点

节点和标识

• rad_id：获取您的Radical节点ID
• rad_help：获取Radical命令的帮助

先决条件

1. Radical CLI：确保 rad 命令已安装并在PATH中可用

   # Install Radicle (see https://radicle.xyz for installation instructions)
   curl -sSf https://install.radicle.xyz | sh

1. 德诺：用于运行GitHub MCP服务器

   # Install Deno
   curl -fsSL https://deno.land/install.sh | sh

1. Python环境：使用MCP库的Python 3.8+

   pip install mcp

1. GitHub个人访问令牌：用于GitHub集成

- 首选https://github.com/settings/tokens - 创建具有repo、issues和pull请求权限的新令牌 - 设置为环境变量： GITHUB_PERSONAL_ACCESS_TOKEN

安装

1. 克隆此存储库
2. 安装依赖项：

   pip install -e .

1. 安装官方GitHub MCP服务器：

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

1. 运行安装脚本：

   python setup_mcp.py

用法

快速设置

# Set your GitHub token
export GITHUB_PERSONAL_ACCESS_TOKEN=your_token_here

# Run the setup script
python setup_mcp.py

GitHub↔ Radical同步

# Test sync connectivity
python demo_sync.py

# Create a test issue (optional)
python create_test_issue.py

# Run full sync
python github_radicle_sync.py

# Or use CLI interface
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 Server
python -m radicle_mcp.server

# GitHub MCP Server  
github-mcp

使用克劳德桌面

安装脚本会自动创建配置。你的 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代码集成

此项目包括用于调试MCP服务器的VS代码配置。使用提供的 mcp.json 文件以连接兼容的MCP客户端。

示例命令

一旦连接到MCP客户端，您就可以使用自然语言与两个平台进行交互：

激进行动

• “初始化一个名为“我的项目”的新Radical存储库”
• “使用RID rad:z2克隆存储库…”
• “显示此存储库中的当前补丁”
• “将此存储库与网络同步”
• “我的Radical节点ID是什么？”

GitHub运营

• “创建一个名为‘真棒项目’的新GitHub存储库”
• “列出我最近的GitHub存储库”
• “创建一个标题为“需要修复Bug”的问题”
• “在我的存储库中显示打开的拉取请求”
• “搜索与‘机器学习’相关的存储库”

跨平台工作流

• “将此Radical存储库发布到GitHub”
• “Radical和GitHub之间的同步问题”
• “比较两个平台上的此存储库”

发展

运行测试

python -m pytest tests/

代码的风格

black src/
flake8 src/

项目结构

radicle-mcp/
├── src/radicle_mcp/
│   ├── __init__.py
│   └── server.py          # Main MCP server implementation
├── .vscode/
│   └── mcp.json          # VS Code MCP configuration
├── .github/
│   └── copilot-instructions.md
├── pyproject.toml        # Project configuration
└── README.md

贡献

1. 分叉存储库
2. 创建要素分支
3. 进行更改
4. 如果适用，添加测试
5. 提交拉取请求

许可证

MIT许可证-有关详细信息，请参阅许可证文件

相关链接

• Radical文档
• 模型上下文协议
• MCP Python SDK