MCP Merge Request Summarizer

Provides automatic MR summaries by analyzing git commits and generating structured reports.

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "sonicjoy-mcp_merge_request_summarizer": {
      "command": "python",
      "args": [
        "-m",
        "mcp_mr_summarizer.server"
      ]
    }
  }
}

You have a dedicated MCP server that automatically generates comprehensive merge request summaries by analyzing git logs, categorizing changes, and producing structured reports. It helps teams clearly communicate what changed, why it changed, and what to review, saving time during code reviews and ensuring consistency across MR descriptions.

How to use

Run the MCP Merge Request Summarizer server and connect your MCP client to generate rich MR summaries. You can use it as a standalone tool to produce Markdown or JSON summaries from your git history, or you can run it as an MCP server to integrate with editors and IDEs that support MCP.

How to install

Prerequisites: Python 3.8+ and Git must be installed on your machine. You will also need Pip to install Python packages.

Step 1: Clone the project repository.

Step 2: Install dependencies in editable mode.

git clone https://github.com/sonicjoy/mcp_merge_request_summarizer.git
cd mcp_merge_request_summarizer
pip install -e .

Step 3: Run the MCP server using Python.

python -m mcp_mr_summarizer.server

Step 4: If you need to test the standalone CLI, you can run the following to compare branches and output a Markdown summary.

python -m mcp_mr_summarizer.cli --base main --current feature/new-feature --output mr_summary.md

Configuration and MCP server setup

Configure your MCP client to point to the configurable server. The example below shows how to register the server as an MCP endpoint.

{
  "mcp.servers": {
    "merge-request-summarizer": {
      "command": "python",
      "args": ["-m", "mcp_mr_summarizer.server"]
    }
  }
}

Available tools

set_working_directory

Set the agent's working directory context for repository operations.

get_working_directory

Retrieve the current working directory context used by the agent.

generate_merge_request_summary

Create a full merge request summary with overview, statistics, changes, and estimated review time.

analyze_git_commits

Provide detailed analysis of commits between branches, including categorization by type.