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

Related MCP server: mcp-server-github

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