kopfrechner

๐Ÿš€ GitLab MR MCP

Community kopfrechner
Updated

Interact seamlessly with GitLab repositories to manage merge requests and issues. Fetch details, add comments, and streamline your code review process with ease.

GitHub starsLicensesmithery badge

๐Ÿš€ GitLab MR MCP

A Model Context Protocol (MCP) server for interacting with GitLab merge requests and issues.

๐Ÿ“Œ Overview

This project implements a server using the Model Context Protocol (MCP) that allows AI agents to interact with GitLab repositories. It provides tools for:

  • Listing available GitLab projects
  • Fetching merge request details and comments
  • Getting merge request diffs
  • Adding comments to merge requests
  • Adding line-specific comments to code in merge request diffs
  • Fetching issue details

๐Ÿ“ฆ Installation

โšก Using Smithery

To install GitLab MR MCP for Claude Desktop automatically via Smithery:

npx -y @smithery/cli@latest install @kopfrechner/gitlab-mr-mcp --client claude --config '"{\"gitlabMrMcpToken\":\"YOUR_GITLAB_TOKEN\"}"'

๐Ÿ› ๏ธ Manual Installation

๐Ÿ”ง Prerequisites
  • Node.js
  • GitLab access token with API access
  • GitLab project ID(s)
๐Ÿ“– Setup
  1. Clone this repository
  2. Install dependencies:
npm install
  1. Add the following to your MCP client configuration:
{
  "mcpServers": {
    "gitlab-mr-mcp": {
      "command": "node",
      "args": ["/path/to/gitlab-mr-mcp/index.js"]
    }
    "env": {
      "MR_MCP_GITLAB_TOKEN": "your_gitlab_token"
    }
  }
}

๐Ÿ› ๏ธ Available Tools

  • get_projectsGets a list of GitLab projects accessible with your token.

  • list_open_merge_requestsLists all open merge requests in the specified project.

  • get_merge_request_detailsGets detailed information about a specific merge request.

  • get_merge_request_commentsGets comments from a specific merge request, including discussion notes and diff notes.

  • add_merge_request_commentAdds a general comment to a merge request.

  • add_merge_request_diff_commentAdds a comment to a specific line in a file within a merge request.

  • get_merge_request_diffGets the diff for a merge request.

  • get_issue_detailsGets detailed information about a specific issue.

๐Ÿ—๏ธ Development

๐Ÿ” Running Inspector

Set up environment variables:

export MR_MCP_GITLAB_TOKEN=your_gitlab_token

For use with MCP clients, you can run:

npx -y @modelcontextprotocol/inspector npm start

๐Ÿ› ๏ธ Troubleshooting

If you encounter permissions issues (403 Forbidden), check:

  1. Your GitLab token has the proper scopes (api, read_api)
  2. The token user has proper access to the projects
  3. The project IDs are correct

๐Ÿ“œ License

MIT

๐Ÿค Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

MCP Server ยท Populars

MCP Server ยท New