GitHub MCP Server

Complete GitHub and local git integration for ADK-Rust Enterprise agents. Provides 38 MCP tools covering the full repository lifecycle — from create_repository through git_push to create_release.

Architecture

Key Principles

• Full lifecycle — create repos, clone, branch, commit, push, open PRs, review, merge, release.
• Real GitHub API — all remote tools call the live GitHub REST API with your PAT.
• Local git operations — clone, init, add, commit, push, tag, log via local git binary.
• Governed writes — issue creation, PR reviews, merges, and repo deletion are write operations.
• Registry-ready — ships with mcp-server.toml for ADK-Rust Enterprise onboarding.

Tools (38)

GitHub API — Search & Discovery

Tool	Purpose	Risk Class
search_repositories	Search GitHub repositories by query	Read-only
search_code	Search code across repositories	Read-only

GitHub API — Repositories

Tool	Purpose	Risk Class
get_repository	Get repo details (branch, language, stats)	Read-only
create_repository	Create a new repo (personal or org)	External write
fork_repository	Fork a repository to your account	External write
delete_repository	Delete a repository (irreversible)	Critical write
list_branches	List branches with protection status	Read-only
list_directory	Browse repo tree contents	Read-only
list_tags	List git tags	Read-only

GitHub API — Files

Tool	Purpose	Risk Class
get_file_contents	Read file contents (decoded from base64)	Read-only
create_or_update_file	Push file changes via API	External write

GitHub API — Pull Requests

Tool	Purpose	Risk Class
list_pull_requests	List PRs by state	Read-only
get_pull_request	Get PR with merge status and stats	Read-only
get_pull_request_diff	Get full diff for a PR	Read-only
create_pull_request	Open a new PR	External write
merge_pull_request	Merge a PR (merge/squash/rebase)	External write
create_pull_request_review	Submit review (APPROVE/REQUEST_CHANGES/COMMENT)	External write
list_pr_comments	List comments on a PR	Read-only
add_pr_comment	Add a comment to a PR	External write

GitHub API — Branches & Commits

Tool	Purpose	Risk Class
create_branch	Create a new branch from a SHA	External write
delete_branch	Delete a branch	External write
list_commits	List commits for a repo or branch	Read-only
get_commit	Get details of a specific commit	Read-only

GitHub API — Issues

Tool	Purpose	Risk Class
create_issue	Create a new issue	External write
update_issue	Update issue title, body, state, labels	External write

GitHub API — CI/Actions

Tool	Purpose	Risk Class
list_workflow_runs	List GitHub Actions workflow runs	Read-only
get_workflow_run	Get details of a specific run	Read-only

GitHub API — Releases

Tool	Purpose	Risk Class
list_releases	List releases for a repository	Read-only
create_release	Create a GitHub release	External write
create_release_note	Generate release notes between tags	Read-only

Local Git Operations

Tool	Purpose	Risk Class
git_clone	Clone a repository to local filesystem	Local write
git_init	Initialize a new git repository	Local write
git_status	Get working tree status	Read-only
git_add	Stage files for commit	Local write
git_commit	Create a commit with message	Local write
git_push	Push commits to remote	External write
git_tag	Create a git tag	Local write
git_log	Show recent commit history	Read-only

Verified Output

Tested against live GitHub API:

> search_repositories("org:zavora-ai mcp")
  ✓ 10 repos found

> get_repository(owner: "zavora-ai", repo: "mcp-a2a")
  ✓ zavora-ai/mcp-a2a | branch: main | lang: Rust

> list_tags(owner: "zavora-ai", repo: "mcp-a2a")
  ✓ v1.1.0 (7b5acb11), v1.0.0 (48e124f1)

> get_file_contents(owner: "zavora-ai", repo: "mcp-a2a", path: "Cargo.toml")
  ✓ 1191 bytes | sha: 6dab006f

> create_issue(owner: "zavora-ai", repo: "mcp-registry", title: "[Test] Integration verified")
  ✓ #1 created → https://github.com/zavora-ai/mcp-registry/issues/1

> git_log(path: ".", count: 3)
  ✓ 98768c9 feat: GitHub MCP v1.1.0 — 24 tools, full PR lifecycle, verified

Installation

Build from source

git clone https://github.com/zavora-ai/adk-mcp-github
cd adk-mcp-github
cargo build --release

The binary is at target/release/adk-mcp-github.

Configuration

export GITHUB_TOKEN=ghp_xxxxxxxxxxxx

Required scopes: repo, read:org, workflow (for Actions tools).

Claude Desktop

{
  "mcpServers": {
    "github": {
      "command": "/path/to/adk-mcp-github",
      "env": { "GITHUB_TOKEN": "ghp_xxxx" }
    }
  }
}

Kiro

{
  "mcpServers": {
    "github": {
      "command": "/path/to/adk-mcp-github",
      "env": { "GITHUB_TOKEN": "ghp_xxxx" }
    }
  }
}

Cursor

{
  "mcpServers": {
    "github": {
      "command": "/path/to/adk-mcp-github",
      "env": { "GITHUB_TOKEN": "ghp_xxxx" }
    }
  }
}

Windsurf

{
  "mcpServers": {
    "github": {
      "command": "/path/to/adk-mcp-github",
      "env": { "GITHUB_TOKEN": "ghp_xxxx" }
    }
  }
}

Governance

• delete_repository is irreversible — requires explicit confirmation in production
• PR reviews require appropriate repo permissions
• merge_pull_request respects branch protection rules
• git_push requires configured credentials on the local machine
• All write operations are audit-logged when used with MCP Registry

MCP Server Manifest

server_id = "mcp_github"
display_name = "GitHub MCP"
version = "1.2.1"
domain = "developer"
risk_level = "medium"
writes_allowed = "gated"
transports = ["stdio"]
governance_gates = ["repo_policy", "codeowners_check"]

Contributors

James Karanja Maina

License

Apache-2.0 — see LICENSE for details.

---

Part of the ADK-Rust Enterprise MCP server ecosystem.

Registry Compliance

This server implements the ADK MCP SDK contract:

• HealthCheck — async health probe for registry monitoring
• mcp-server.toml — manifest declaring tools, risk classes, and credentials
• Structured tracing — RUST_LOG env-filter for observability