Skip to content

README.md

Latest commit

 

History

History
94 lines (68 loc) · 3 KB

README.md

File metadata and controls

94 lines (68 loc) · 3 KB

gitant-mcp

MCP (Model Context Protocol) server for gitant. Gives AI agents structured access to a gitant node via the daemon REST API.

Install and run from GitHub — releases or clone + build.

Full setup guide: gitant-daemon docs/QUICKSTART.md

Install from GitHub

git clone https://github.com/GrayCodeAI/gitant-mcp.git
cd gitant-mcp
make build
make run

Requires Node.js 20+.

Or download a tagged release tarball, extract, and run node dist/index.js (pre-built dist/ is included in release artifacts).

Environment

Variable Default Description
GITANT_DAEMON_URL http://localhost:7777 Daemon base URL
GITANT_UCAN_TOKEN — Bearer UCAN token (required for write operations)

MCP client config

Point your MCP client at the built entrypoint (adjust the path):

{
  "mcpServers": {
    "gitant": {
      "command": "node",
      "args": ["/path/to/gitant-mcp/dist/index.js"],
      "env": {
        "GITANT_DAEMON_URL": "http://localhost:7777",
        "GITANT_UCAN_TOKEN": "your-delegated-ucan-token"
      }
    }
  }
}

Tools (64)

System

  • get_daemon_status — Health + node status
  • get_network_status — libp2p peers and listen addresses
  • discover_federation — Federated node discovery (requires --p2p)
  • get_bootstrap_peers — List federation bootstrap multiaddrs
  • attest_agent — Cross-peer agent trust attestation
  • list_repos, get_repo, create_repo, delete_repo, fork_repository
  • push_code — Push git objects + ref updates
  • push_packfile — Push base64-encoded packfile + ref updates
  • clone_repo

List tools accept optional offset and limit pagination parameters.

Files & search

  • get_file, list_files, search_code

Issues & PRs

  • create_issue, list_issues, get_issue, close_issue
  • add_issue_comment, list_issue_comments
  • open_pr, list_prs, get_pr, review_pr, merge_pr
  • list_pr_comments

Use string IDs for issues/PRs (e.g. issue-1734567890123456789, pr-1734567890123456789).

Git refs & commits

  • list_refs, create_branch, get_commit_log, diff_commits, get_commit_parents

Agents & UCAN

  • generate_did, resolve_did, list_agents, get_agent, get_agent_profile
  • delegate_capability, verify_ucan, revoke_ucan, list_revocations

Webhooks, tasks, releases, labels, stars, protection, activity

  • Full CRUD/list tools for each domain (see src/index.ts)

Releases

Push a version tag — GitHub Actions builds and attaches a tarball:

git tag v0.1.0 && git push origin v0.1.0

See Release workflow.

See PLAN.md in gitant-daemon for the full product roadmap.