把你的AI助手连接到GitLab。直接在你的聊天里问诸如_“列表未合并请求”、“显示MR #123的评价”、“获取MR #456提交讨论”或“查找功能分支的合并请求”_。

目录

• 快速设置
• 你能做的事
• 配置选项
• 故障排除
• 工具参考
• 路线图
• 发展
• 安全说明
• 支持

快速布置

安装

注意： 建议使用 pipx 或 uv tool，因为它们会自动将 gitlab-mcp 命令添加到你的 PATH。如果使用 pip install，请确保你的 Python 脚本目录在 PATH，或者使用命令的完整路径。

获取你的GitLab令牌

1. 进入GitLab→设置→访问令牌
2. 创建带有 read_api 作用域的令牌（如果你想要写权限，可以添加 [api 作用域）
3. 复制令牌

配置你的MCP客户端

多项目设置（推荐）

对于处理多个GitLab项目，请在你的全局MCP配置中添加（~/.cursor/mcp.json用于Cursor）：

这个单一配置适用于你所有的项目。使用 search_projects 或 list_my_projects 查找项目ID，然后在请求中指定project_id。

GitLab MR MCP

Connect your AI assistant to GitLab. Ask questions like “List open merge requests”, “Show me reviews for MR #123”, “Get commit discussions for MR #456”, or “Find merge requests for the feature branch” directly in your chat.

Table of Contents

• Quick Setup
• What You Can Do
• Configuration Options
• Troubleshooting
• Tool Reference
• Roadmap
• Development
• Security Notes
• Support

Quick Setup

Installation

# Using pipx (recommended)
pipx install gitlab-mr-mcp

# Or using uv
uv tool install gitlab-mr-mcp

# Or using pip
pip install gitlab-mr-mcp

Note: Using pipx or uv tool is recommended as they automatically add the gitlab-mcp command to your PATH. If using pip install, ensure your Python scripts directory is in PATH, or use the full path to the command.

Get your GitLab token

1. Go to GitLab → Settings → Access Tokens
2. Create token with read_api scope (add api scope if you want write access)
3. Copy the token

Configure your MCP client

Multi-Project Setup (Recommended)

For working with multiple GitLab projects, add to your global MCP config (~/.cursor/mcp.json for Cursor):

{
  "mcpServers": {
    "gitlab-mcp": {
      "command": "gitlab-mcp",
      "env": {
        "GITLAB_URL": "https://gitlab.com",
        "GITLAB_ACCESS_TOKEN": "glpat-xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

This single configuration works across all your projects. Use search_projects or list_my_projects to find project IDs, then specify project_id in your requests.

Single-Project Setup

For working with a single project, you can set a default project ID:

{
  "mcpServers": {
    "gitlab-mcp": {
      "command": "gitlab-mcp",
      "env": {
        "GITLAB_URL": "https://gitlab.com",
        "GITLAB_ACCESS_TOKEN": "glpat-xxxxxxxxxxxxxxxxxxxx",
        "GITLAB_PROJECT_ID": "12345"
      }
    }
  }
}

Restart your MCP client and start asking GitLab questions!

What You Can Do

Once connected, try these commands in your chat:

Multi-Project Workflow

• “What projects do I have access to?”
• “Search for the backend project”
• “Show open MRs for project 12345”