Provides automated GitHub Pull Request analysis and review capabilities, including fetching PR details, analyzing code changes, and optionally posting AI-generated reviews back to GitHub
Connects to Google's Gemini AI models through the Gemini CLI for performing intelligent code reviews and PR analysis
Integrates with local Ollama instances to perform AI-powered code reviews using locally-hosted language models like llama3.1, codellama, and mistral
GitHub MCP Server
Minimal Model Context Protocol (MCP) server that exposes GitHub-focused tools for AI assistants.
🔧 Quick Start (Local)
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
):
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.
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/
.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Enables automated GitHub Pull Request reviews using local Ollama, Cursor CLI, or Gemini CLI as AI providers. Supports customizable review prompts, comprehensive PR analysis, and optional auto-posting of reviews to GitHub.
Related MCP Servers
- -securityFlicense-qualityAn MCP service that enables creating GitHub Pull Requests and adding code review comments using GitHub CLI, eliminating the need to manually handle authentication and permissions.Last updated -
- -securityFlicense-qualityA server that integrates with Cursor IDE to provide code review functionality for Azure repositories, enabling AI-powered pull request analysis and feedback.Last updated -2
- -securityFlicense-qualityA tool that integrates with GitHub and Notion to analyze and review pull requests, enabling automated code reviews and documentation in Notion.Last updated -
- -securityFlicense-qualityAn intelligent assistant for Pull Request analysis that integrates GitHub with Notion for automated review documentation through an MCP (Model-Controller-Provider) server architecture.Last updated -1