git-mcp

An stdio-based MCP server that automates creating Pull Requests (GitHub) and Merge Requests (GitLab) using git CLI, repository templates, and LLM-assisted content generation.

Features

• 🔍 Auto-detects platform (GitHub / GitLab) from your git remote URL
• 📝 Template-aware — uses your repo's PR/MR templates if available
• 🤖 LLM-powered — when no template exists, the MCP client generates context-aware PR/MR content from your diff and commit log
• 🚀 One-step publish — creates PRs/MRs directly via GitHub & GitLab APIs

Tools

Tool	Description
get_repo_info	Returns current branch, default branch, remote URL, and detected platform
list_templates	Lists all PR/MR templates found in the repository
prepare_merge_request	Gathers diff, commit log, changed files, and template data for the LLM to compose PR/MR content
publish_merge_request	Creates a PR (GitHub) or MR (GitLab) with the given title and body

Setup

Prerequisites

• Node.js v18+
• Git CLI installed and accessible in PATH

Install

git clone https://github.com/your-username/git-mcp.git
cd git-mcp
npm install
npm run build

Environment Variables

Variable	Required	Description
GITHUB_TOKEN	For GitHub repos	GitHub Personal Access Token with repo scope
GITLAB_TOKEN	For GitLab repos	GitLab Personal Access Token with api scope

Configure MCP Client

Add to your MCP client configuration (e.g. Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "git-mcp": {
      "command": "node",
      "args": ["C:/path/to/git-mcp/dist/index.js"],
      "env": {
        "GITHUB_TOKEN": "ghp_your_token_here",
        "GITLAB_TOKEN": "glpat-your_token_here"
      }
    }
  }
}

Usage

Once configured, ask your MCP client (e.g. Claude) something like:

"Create a pull request for my current branch"

The workflow:

1. get_repo_info — The LLM checks your repo context
2. prepare_merge_request — Gathers diff, log, and templates
3. The LLM composes a PR/MR title and body (using your template if available)
4. publish_merge_request — Publishes to GitHub or GitLab

Development

npm run dev    # Watch mode — recompiles on changes
npm run build  # One-time build
npm start      # Run the server

Template Discovery

The server searches for templates in these locations:

GitHub:

• .github/pull_request_template.md
• .github/PULL_REQUEST_TEMPLATE.md
• .github/PULL_REQUEST_TEMPLATE/default.md
• docs/pull_request_template.md
• PULL_REQUEST_TEMPLATE.md

GitLab:

• .gitlab/merge_request_templates/Default.md
• .gitlab/merge_request_templates/default.md

License

MIT