Radicle GitHub

MCP Server for radicle.xyz decentralized git-based PR and issues

python

0

GitHub Stars

python

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "fovi-llc-radicle-mcp": {
      "command": "python",
      "args": [
        "-m",
        "radicle_mcp.server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_XXXXXXXXXXXXXXXXXXXX"
      }
    }
  }
}

This Model Context Protocol (MCP) server setup provides parallel interfaces to Radicle and GitHub through a unified, programmable client. You can manage Radicle repositories, sync with the Radicle network, handle patches and issues, and simultaneously operate GitHub repositories, issues, and pull requests from a single control plane. The cross-platform synchronization features help keep issues and related metadata aligned across Radicle and GitHub.

How to use

Connect with your MCP client to manage both Radicle and GitHub resources from one place. You can perform repository operations, synchronize between platforms, and use the integrated tools to list, create, or update items across Radicle and GitHub. The system preserves metadata where possible and supports idempotent operations so repeated actions do not create duplicates.

How to install

Prerequisites you need before starting: a Python environment for the Radicle MCP server, and a runtime for the GitHub MCP server.

Commands to set up each component and prepare your environment:

Install Radicle MCP server prerequisites and run the Python server as a standalone process.

Additional configuration and usage notes

The setup creates a configuration structure that ties both MCP servers into your environment. You can provide environment variables to secure tokens and tailor runtime behavior.

Available tools

rad_init

Initialize a new Radicle repository within the MCP server workflow.

rad_clone

Clone an existing Radicle repository by RID.

rad_status

Retrieve the status and metadata of a Radicle repository.

rad_sync

Synchronize a Radicle repository with the Radicle network.

rad_push

Push local changes to the Radicle network.

rad_patch_list

List patches (pull requests) in a repository.

rad_issue_list

List issues in a repository.

rad_remote_list

List remotes/nodes associated with a repository.

rad_id

Retrieve your Radicle node ID.

rad_help

Provide command help for Radicle-related operations.

github_sync_test

Test connectivity between MCP and GitHub integration.

github_sync_issues

Synchronize GitHub issues with Radicle patches or vice versa.

github_sync_full

Perform full bidirectional synchronization between GitHub and Radicle.