GitHub MCP Server

Minimal Model Context Protocol (MCP) server that exposes GitHub-focused tools for AI assistants.

Quick Start (Local)

# 1. Clone & install
 git clone <repo-url>
 cd github-review-mcp
 pnpm install

# 2. Add credentials
 echo "GITHUB_TOKEN=ghp_your_token_here" > .env

# 3. Run the server
 pnpm start

The server listens on the port specified by your MCP client (default 3000).

Using from an MCP Client

Cursor IDE

Add this to Settings Extensions MCP (or your mcp-servers.json):

{
  "mcpServers": {
    "github-review-server": {
      "command": "node",
      "args": ["/absolute/path/github-review-mcp/src/index.js"],
      "env": { "GITHUB_TOKEN": "ghp_your_token_here" }
    }
  }
}

Generic MCP Client

Point the client to node /absolute/path/github-review-mcp/src/index.js and pass GITHUB_TOKEN in the environment.

Docker (Hosted)

A Dockerfile mirroring the hosted image is included.

# Build
 docker build -t gh-mcp .

# Run
 docker run -e GITHUB_TOKEN=ghp_your_token_here -p 3000:3000 gh-mcp

Attach the container to your MCP client using http://localhost:3000 (or the mapped port) as the command.

Environment Variables

Available Tools

Core PR utilities plus advanced analysis modules:

• get_review_prompts (call this first!)
• get_pr_details
• get_pr_files
• get_pr_commits
• get_file_content
• post_pr_review
• get_repo_info

Advanced analysis ():

• analyze_code_quality
• analyze_diff_impact
• detect_security_issues
• detect_code_patterns
• analyze_dependencies
• analyze_test_coverage
• generate_suggestions

For detailed usage examples, see the original README history or the inline JSDoc in src/tools/.