GitLab MR MCP 是一款 MCP 服务器，旨在通过模型上下文协议(MCP)连接 AI 智能体与 GitLab 代码仓库。它提供了一系列工具，使 AI 能够与 GitLab 的合并请求和问题进行交互，例如获取项目列表、提取合并请求的详细信息和评论、获取代码差异(diff)，以及在合并请求中添加评论，甚至可以针对特定代码行添加评论。

通过 GitLab MR MCP，开发者可以构建更智能的自动化工作流，例如自动代码审查、问题分析和修复建议。它简化了 AI 模型与 GitLab 之间的集成，无需复杂的 API 调用，只需通过 MCP 协议即可实现无缝交互。该服务器通过标准输入/输出或 HTTP/SSE 等传输机制与 MCP 客户端通信，易于集成到现有的开发环境中。使用 GitLab MR MCP，开发者可以显著提升代码协作效率，并充分利用 AI 的能力来改进软件开发流程。

获取GitLab项目列表

gitlab-mr-mcp 允许AI模型通过 get_projects 工具获取用户有权访问的GitLab项目列表。该功能通过用户的GitLab访问令牌进行身份验证，并返回项目名称和ID等基本信息。这使得AI能够动态发现可交互的GitLab仓库，无需硬编码项目信息。例如，AI助手可以利用此功能，在用户未明确指定项目的情况下，先列出所有可用项目供用户选择，然后再执行后续操作，如获取特定项目的合并请求。技术实现上，该工具调用GitLab API的projects endpoint，并将返回结果格式化为MCP兼容的格式。如果用户配置的GitLab Token没有访问项目的权限，将会返回错误信息。

获取合并请求详情

通过 get_merge_request_details 工具，AI模型可以获取指定GitLab项目中特定合并请求的详细信息。这些信息包括标题、描述、状态、作者、创建时间、修改时间和相关链接等。AI可以利用这些信息进行代码审查、风险评估或自动生成发布说明。例如，AI可以分析合并请求的描述和修改内容，判断其是否符合项目规范，并自动生成审查意见。技术实现上，该工具调用GitLab API的merge requests endpoint，需要提供项目ID和合并请求ID作为参数。返回的数据经过解析和格式化，确保符合MCP协议的要求，方便AI模型进行处理。

添加合并请求评论

add_merge_request_comment 工具允许AI模型在指定的GitLab合并请求中添加评论。这使得AI能够直接参与代码审查过程，提供反馈、提出问题或进行讨论。例如，AI可以自动检测代码中的潜在问题，并在合并请求中添加评论，提醒开发者注意。或者，AI可以根据代码修改的内容，自动生成总结性的评论，方便其他开发者快速了解变更。技术实现上，该工具调用GitLab API的merge request notes endpoint，需要提供项目ID、合并请求ID和评论内容作为参数。为了保证评论的有效性，建议AI在生成评论前，先对内容进行格式化和校验。

添加行级代码评论

add_merge_request_diff_comment 工具允许AI模型在GitLab合并请求的特定代码行上添加评论。这使得AI能够针对代码的具体问题进行精确的反馈，提高代码审查的效率。例如，AI可以检测代码中的潜在bug，并在相应的代码行上添加评论，指出问题所在。或者，AI可以针对代码的可读性或性能提出改进建议，并在相应的代码行上添加评论。技术实现上，该工具调用GitLab API的merge request diff notes endpoint，需要提供项目ID、合并请求ID、文件路径、代码行号和评论内容作为参数。为了保证评论的准确性，AI需要精确地定位代码行，并确保评论内容与代码上下文相关。

技术实现

gitlab-mr-mcp 基于Node.js构建，通过调用GitLab API实现与GitLab仓库的交互。它使用环境变量 MR_MCP_GITLAB_TOKEN 来存储GitLab访问令牌，保证了令牌的安全性。该项目实现了MCP服务器的标准接口，可以与任何兼容MCP协议的客户端进行通信。为了方便开发者调试和测试，该项目还提供了使用 @modelcontextprotocol/inspector 运行检查器的功能。