GitHub MCP Server

A Model Context Protocol (MCP) server for GitHub operations. This server provides tools for listing PRs, getting commit details, and comparing changes - useful for understanding what changed in a build or investigating test failures.

Installation

npm install -g @bugzy-ai/github-mcp-server

Or use with npx:

npx @bugzy-ai/github-mcp-server

Configuration

Set the GITHUB_TOKEN environment variable with a token that has repo scope:

export GITHUB_TOKEN=ghp_your_token_here

Available Tools

github_list_prs

List pull requests in a repository with optional filters.

Parameters:

• owner (required): Repository owner
• repo (required): Repository name
• state (optional): Filter by state - "open", "closed", or "all" (default: "all")
• base (optional): Filter by base branch
• sort (optional): Sort by "created", "updated", "popularity", or "long-running"
• direction (optional): Sort direction - "asc" or "desc"
• per_page (optional): Results per page (max 100)
• page (optional): Page number

github_get_pr

Get detailed information about a specific pull request.

Parameters:

• owner (required): Repository owner
• repo (required): Repository name
• pull_number (required): Pull request number

github_list_commits

List commits on a branch with optional date range filters.

Parameters:

• owner (required): Repository owner
• repo (required): Repository name
• sha (optional): Branch name, tag, or commit SHA
• since (optional): Only commits after this date (ISO 8601)
• until (optional): Only commits before this date (ISO 8601)
• per_page (optional): Results per page (max 100)
• page (optional): Page number

github_get_commit

Get detailed information about a specific commit.

Parameters:

• owner (required): Repository owner
• repo (required): Repository name
• ref (required): Commit SHA, branch name, or tag name

github_compare_commits

Compare two commits, branches, or tags.

Parameters:

• owner (required): Repository owner
• repo (required): Repository name
• base (required): Base ref (branch, tag, or SHA)
• head (required): Head ref (branch, tag, or SHA)
• per_page (optional): Results per page (max 100)
• page (optional): Page number

MCP Configuration

Add to your .mcp.json:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@bugzy-ai/github-mcp-server"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

License

Apache-2.0