MCP GitHub Context

A Model Context Protocol (MCP) server that provides GitHub context to AI assistants and editors.

✨ Features

• 📥 Fetch pull request diffs
• 📋 List and inspect pull requests, comments, and reviews
• 📁 List files in PRs and inspect commits
• 🔀 Compare branches
• 🔍 Extract Git remote info from local repositories

📦 Installation

From npm

npm install -g mcp-github-context

From source

git clone https://github.com/junielton/mcp-github-context.git
cd mcp-github-context
npm install
npm run build

🚀 Usage

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | GITHUB_TOKEN | Recommended | GitHub Personal Access Token for private repos and higher rate limits (5000/hour vs 60/hour) |

Generate a token at: https://github.com/settings/tokens Required scopes: repo for private repos, or public_repo for public only.

Running the server

# Development
GITHUB_TOKEN=your_token npm run dev

# Production
GITHUB_TOKEN=your_token npm start

# If installed globally
GITHUB_TOKEN=your_token mcp-github-context

🔧 MCP Client Configuration

Add this to your MCP client configuration (e.g., Claude, Cursor, etc.):

Using npx (recommended)

{
  "mcpServers": {
    "github-context": {
      "command": "npx",
      "args": ["-y", "mcp-github-context"],
      "env": {
        "GITHUB_TOKEN": "your_github_token_here"
      }
    }
  }
}

Using global install

{
  "mcpServers": {
    "github-context": {
      "command": "mcp-github-context",
      "env": {
        "GITHUB_TOKEN": "your_github_token_here"
      }
    }
  }
}

Using local install

{
  "mcpServers": {
    "github-context": {
      "command": "node",
      "args": ["/path/to/mcp-github-context/dist/server.js"],
      "env": {
        "GITHUB_TOKEN": "your_github_token_here"
      }
    }
  }
}

🛠️ Available Tools

| Tool | Description | |------|-------------| | fetch_github_pr_diff | Fetch raw diff content from a PR | | list_pull_requests | List PRs with optional filters (state, limit) | | get_pr_details | Get complete PR details (title, body, labels, stats) | | get_pr_comments | Fetch all PR comments (general + review) | | get_pr_reviews | Get all PR reviews with status | | get_pr_files | List files changed in a PR with stats | | compare_branches | Compare two branches (commits, files) | | get_commit_details | Get commit info (author, message, files) | | get_git_remote_info | Extract owner/repo from local Git repository |

💡 Example Prompts

Once configured, you can use prompts like:

• "List the open PRs in facebook/react"
• "Get details of PR #123 from org/repo"
• "Show me the diff for PR #456"
• "Compare main and develop branches in org/repo"
• "What files were changed in commit abc123?"

📄 License

Apache-2.0 — see LICENSE

👤 Author

junielton - GitHub

🙏 Acknowledgments

• Built on the Model Context Protocol
• Powered by GitHub REST API