mcp-gitlab MCP Server

mcp-gitlab MCP Server

site icon
2025.04.14 0
TypeScriptGitLab 集成API 管理开发工具交流协作
ZephyrDeng_mcp-server-gitlab 是一个基于 Model Context Protocol (MCP) 框架构建的 GitLab 集成服务器,提供多种 GitLab RESTful API 工具,支持 Claude、Smithery 等平台集成。该服务器主要用于与 GitLab 进行交互,包括搜索用户项目、获取用户任务、管理合并请求等功能。
View on GitHub

Overview

基本能力

产品定位

ZephyrDeng_mcp-server-gitlab 是一个 GitLab 集成服务器,旨在通过 MCP 框架提供 GitLab API 的便捷访问和管理工具。

核心功能

  • GitlabSearchUserProjectsTool:根据用户名搜索用户及其活跃项目
  • GitlabGetUserTasksTool:获取当前用户的待办任务
  • GitlabSearchProjectDetailsTool:搜索项目及详细信息
  • GitlabCreateMRCommentTool:为合并请求添加评论
  • GitlabAcceptMRTool:接受并合并合并请求
  • GitlabUpdateMRTool:更新 Merge Request 的指派人、评审人、标题、描述、标签
  • GitlabCreateMRTool:创建新的 Merge Request,支持指派 assignee 和 reviewers
  • GitlabRawApiTool:自定义调用任意 GitLab API

适用场景

  • 开发团队需要自动化管理 GitLab 项目
  • 需要集成 GitLab API 到其他平台(如 Claude、Smithery)
  • 需要批量处理 GitLab 任务或合并请求

工具列表

  1. GitlabSearchUserProjectsTool:搜索用户及其活跃项目
  2. GitlabGetUserTasksTool:获取用户待办任务
  3. GitlabSearchProjectDetailsTool:搜索项目详细信息
  4. GitlabCreateMRCommentTool:为合并请求添加评论
  5. GitlabAcceptMRTool:接受合并请求
  6. GitlabUpdateMRTool:更新合并请求信息
  7. GitlabCreateMRTool:创建新的合并请求
  8. GitlabRawApiTool:自定义调用 GitLab API

常见问题解答

  • 如何配置 GitLab API URL 和访问令牌? 通过环境变量 GITLAB_API_URLGITLAB_TOKEN 进行配置。
  • 如何集成到 Claude 桌面客户端? 在配置文件中添加相应的 MCP 服务器配置。

使用教程

使用依赖

# 安装依赖
bun install

安装教程

# 构建项目
bun run build

# 启动服务
bun run start

调试方式

确保环境变量已正确配置:

GITLAB_API_URL=https://your-gitlab-instance.com
GITLAB_TOKEN=your_access_token

然后启动服务并检查日志输出。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。