Github Review MCP

🚀 GitHub MCP Server

This is a Minimal Model Context Protocol (MCP) server that offers GitHub - focused tools for AI assistants.

🚀 Quick Start

🔧 Local Setup

# 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).

🐳 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.

💻 Usage Examples

🖥️ 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.

📚 Documentation

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