# git-mcp

An stdio-based [MCP](https://modelcontextprotocol.io/) 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](https://nodejs.org/) v18+
- Git CLI installed and accessible in `PATH`

### Install

```bash
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`):

```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

```bash
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