Git Pr MCP

🚀 Git PR MCP Server

A Model Context Protocol (MCP) server for Git and Pull Request operations, offering tools for repository management and PR workflows.

Built with FastMCP, this server runs in SSE mode by default on 0.0.0.0:8000.

✨ Features

This MCP server provides the following tools and capabilities:

Core Git Operations (on specified repository path)

• get_git_status: Retrieve the current git status of a repository.
• list_branches: List all branches in the repository (with the option to include remote branches).
• create_pr_summary: Generate a summary for a pull request based on git diff.
• get_commit_history: Obtain the commit history for a branch.
• get_git_diff: Get the git diff between commits, branches, or the working directory.

Automated PR Workflow (operates on an internally managed "active" repository)

• clone_repository: Clone a GitHub repository into a managed temporary directory, designating it as the "active" repository for subsequent operations. Automatically clean up the temporary directory of any previously active repository.
• create_git_branch: Create a new branch in the active repository.
• write_file_in_repo: Create or overwrite files within the active repository.
• git_commit_changes: Stage all changes (git add .) and commit them in the active repository.
• git_push_branch: Push a specified branch from the active repository to its remote origin.
• create_github_pr: Create a pull request on GitHub for the active repository using the PyGithub library. Requires GITHUB_TOKEN.

State Management

The server maintains the state of the currently "active" cloned repository (path, URL, owner, name) in an active_repo_state.json file. This allows for some persistence across server restarts, although the temporary clone directory itself might be managed by the OS.

📦 Installation

Step 1: Clone the repository

git clone <repository-url>
cd git-pr-mcp

Step 2: Install using uv

uv sync

💻 Usage Examples

Basic Usage

The server runs in SSE mode by default on 0.0.0.0:9999 and is configured via environment variables. Here's a sample .env file:

FASTMCP_HOST=0.0.0.0
FASTMCP_PORT=9999
GITHUB_TOKEN=your_github_token

Quick Start

# Run with defaults (0.0.0.0:8000)
uv run python main.py

# Or run the server module directly
uv run python -m src.git_pr_mcp.server

You can then access the MCP server at http://localhost:9999/sse.