Skip to main content
Glama

MCP Merge Request Summarizer

by sonicjoy

MCP Merge Request Summarizer

An MCP (Model Context Protocol) tool that automatically generates comprehensive merge request summaries from git logs. This tool analyzes commit history, categorizes changes, and produces structured summaries suitable for merge request descriptions.

🚀 Features

  • Automatic Commit Analysis: Analyzes git logs between branches to understand changes
  • Smart Categorization: Categorizes commits by type (features, bug fixes, refactoring, etc.)
  • Comprehensive Summaries: Generates detailed merge request descriptions with:
    • Overview and statistics
    • Key changes and significant commits
    • Categorized changes (features, bug fixes, refactoring)
    • Breaking changes detection
    • File categorization and impact analysis
    • Estimated review time
  • Multiple Output Formats: Supports both Markdown and JSON output
  • Flexible Integration: Works standalone or as MCP server
  • Cross-Platform: Compatible with Windows, macOS, and Linux

📦 Installation

  1. Clone the repository:
    git clone https://github.com/yourusername/mcp-merge-request-summarizer.git cd mcp-merge-request-summarizer
  2. Run the installation script:
    • Windows: Double-click install.bat or run install.bat in PowerShell
    • Mac/Linux: Run chmod +x install.sh && ./install.sh
  3. Configure your editor:
    • See QUICK_START.md for 30-second setup instructions
    • Or check configs/README.md for detailed configuration options

Manual Installation

git clone https://github.com/yourusername/mcp-merge-request-summarizer.git cd mcp-merge-request-summarizer pip install -e .

From PyPI

pip install mcp-merge-request-summarizer

Note: This package is not yet published to PyPI. For now, use the installation scripts or manual installation.

🔧 Usage

As a Standalone Tool

# Basic usage (compares current branch against develop) python -m mcp_mr_summarizer.cli # Specify different branches python -m mcp_mr_summarizer.cli --base main --current feature/new-feature # Output to file python -m mcp_mr_summarizer.cli --output mr_summary.md # JSON output python -m mcp_mr_summarizer.cli --format json --output summary.json # Help python -m mcp_mr_summarizer.cli --help

As an MCP Server

  1. Configure your MCP client (e.g., Claude Desktop, Cursor, VSCode):
    { "mcp.servers": { "merge-request-summarizer": { "command": "python", "args": ["-m", "mcp_mr_summarizer.server"] } } }
  2. Set up working directory context (recommended):
    # Set your working directory so repo_path="." works correctly await set_working_directory("/path/to/your/git/repo")
  3. Use the tools and resources through your MCP client interface:

Tools (Actions)

  • set_working_directory: Set the agent's working directory context
  • get_working_directory: Get the current working directory context
  • generate_merge_request_summary: Creates full MR summaries
  • analyze_git_commits: Provides detailed commit analysis

Resources (Data)

  • git://repo/status: Current repository status and information
  • git://commits/{base_branch}..{current_branch}: Commit history between branches
  • git://branches: List of all repository branches
  • git://files/changed/{base_branch}..{current_branch}: Files changed between branches

📊 Example Output

# feat: 4 new features and improvements ## Overview This merge request contains 9 commits with 35 files changed (1543 insertions, 1485 deletions). ## Key Changes - Refactor mappers in MLB, NBA, NHL, and NFL to use object initializer syntax (bdf5d9c) - 3028 lines changed - Refactor season stats services to use base class and improve dependency injection (30de323) - 1976 lines changed ### 🚀 New Features (4) - Add soccer metrics extraction methods and register soccer season stats service (176930f) - Update services to use constructor injection for dependencies (29f1c46) - Update CbStatsDaemon and CbStatsFeedPublicApi to use async host run methods (22c1202) - Refactor PoolSeasonStatsController and related services (3a28ab4) ### 🔧 Refactoring (3) - Refactor mappers in MLB, NBA, NHL, and NFL to use object initializer syntax (bdf5d9c) - Refactor season stats services to use base class and improve dependency injection (30de323) - Refactor logging in season stats services to use consistent casing (fd7b8b9) ### 📊 Summary - **Total Commits:** 9 - **Files Changed:** 35 - **Lines Added:** 1543 - **Lines Removed:** 1485 - **Estimated Review Time:** 1h 15m

🛠️ Configuration

For VSCode/Cursor:

  1. Open Settings (Ctrl/Cmd + ,)
  2. For VSCode: Search for "mcp" and click "Edit in settings.json"
  3. For Cursor: Go to Tools & IntegrationsNew MCP Server
  4. Add this configuration:

VSCode (settings.json):

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

Cursor (GUI or settings.json):

  • Name: merge-request-summarizer
  • Command: python
  • Arguments: ["-m", "mcp_mr_summarizer.server"]

Cursor (alternative JSON format):

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

For Claude Desktop:

  1. Go to Settings → MCP Servers
  2. Add new server with this configuration:
{ "mcpServers": { "merge-request-summarizer": { "command": "python", "args": ["-m", "mcp_mr_summarizer.server"] } } }

Ready-to-Use Config Files

Copy the appropriate configuration from the configs/ folder:

  • configs/vscode_settings.json - For VSCode
  • configs/cursor_settings.json - For Cursor
  • configs/claude_desktop_config.json - For Claude Desktop

See configs/README.md for detailed setup instructions.

🎯 Customization

Adding Custom Commit Categories

Extend the categorization by modifying the categorize_commit method:

def categorize_commit(self, commit: CommitInfo) -> List[str]: categories = [] message_lower = commit.message.lower() # Add your custom patterns if any(word in message_lower for word in ['security', 'vulnerability']): categories.append('security') # ... existing patterns ... return categories

Customizing File Categories

Add custom file type categories:

def _categorize_files(self, files: set) -> Dict[str, List[str]]: categories = { 'Services': [], 'Models': [], 'Controllers': [], 'Tests': [], 'Configuration': [], 'Documentation': [], 'CustomCategory': [], # Add your custom category 'Other': [] } for file in files: if 'CustomPattern' in file: # Add your custom pattern categories['CustomCategory'].append(file) # ... existing patterns ... return categories

🧪 Testing

# Run tests python -m pytest tests/ # Run with coverage python -m pytest tests/ --cov=mcp_mr_summarizer --cov-report=html

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Make your changes
  4. Add tests for your changes
  5. Run the test suite
  6. Commit your changes (git commit -m 'Add some amazing feature')
  7. Push to the branch (git push origin feature/amazing-feature)
  8. Open a Pull Request

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

  • Built for the Model Context Protocol (MCP) ecosystem
  • Inspired by the need for better merge request documentation
  • Thanks to all contributors and users

📞 Support


Made with ❤️ for developers who want better merge request summaries

-
security - not tested
A
license - permissive license
-
quality - not tested

local-only server

The server can only run on the client's local machine because it depends on local resources.

Automatically generates comprehensive merge request summaries from git logs, analyzing commit history and categorizing changes into structured descriptions. Provides tools to analyze git repositories, compare branches, and create detailed summaries with change categorization, impact analysis, and review time estimates.

  1. 🚀 Features
    1. 📦 Installation
      1. 🚀 Quick Start (Recommended)
      2. Manual Installation
      3. From PyPI
    2. 🔧 Usage
      1. As a Standalone Tool
      2. As an MCP Server
      3. Tools (Actions)
      4. Resources (Data)
    3. 📊 Example Output
      1. 🛠️ Configuration
        1. Quick Configuration (Recommended)
        2. Ready-to-Use Config Files
      2. 🎯 Customization
        1. Adding Custom Commit Categories
        2. Customizing File Categories
      3. 🧪 Testing
        1. 🤝 Contributing
          1. 📝 License
            1. 🙏 Acknowledgments
              1. 📞 Support

                Related MCP Servers

                • A
                  security
                  A
                  license
                  A
                  quality
                  Analyzes git changes in repositories and generates conventional commit messages using OpenAI's GPT models, supporting both staged and unstaged changes with detailed summaries.
                  Last updated -
                  20
                  12
                  MIT License
                • -
                  security
                  A
                  license
                  -
                  quality
                  Integrates GitLab merge request analysis with Confluence documentation, allowing users to fetch merge request details, analyze code changes, and store analysis results in Confluence pages.
                  Last updated -
                  MIT License
                  • Linux
                  • Apple
                • A
                  security
                  F
                  license
                  A
                  quality
                  Provides automated Git workflow tools for committing, creating pull requests, and merging with proper GitHub authentication handling. Supports complete Git workflows from commit to merge with dry run capabilities and conventional commit formatting.
                  Last updated -
                  4
                  1
                • A
                  security
                  A
                  license
                  A
                  quality
                  Automatically generates conventional commit messages from staged git changes and checks repository status. Analyzes git diffs to create properly formatted commit messages following conventional commit standards.
                  Last updated -
                  2
                  6
                  MIT License
                  • Apple
                  • Linux

                View all related MCP servers

                MCP directory API

                We provide all the information about MCP servers via our MCP API.

                curl -X GET 'https://glama.ai/api/mcp/v1/servers/sonicjoy/mcp_merge_request_summarizer'

                If you have feedback or need assistance with the MCP directory API, please join our Discord server