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

| Variable | Description | Default | |-----------------------|---------------------------------------|---------| | GITHUB_TOKEN | GitHub Personal Access Token (required) | - | | MAX_PATCH_SIZE | Maximum diff patch size (chars) | 2000 | | MAX_FILES_TO_REVIEW | Maximum files processed per PR | 50 | | REQUEST_TIMEOUT | HTTP request timeout (ms) | 30000 | | LOG_LEVEL | Logging level (debug, info, …) | info | | ENABLE_DEBUG | Verbose logging (true/false) | false |

🛠️ 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/.