功能概览
2025.04.16
2
TypeScriptGitLab 集成API 工具开发工具开发效率交流协作
mcp-server-gitlab 是基于 Model Context Protocol (MCP) 框架构建的 GitLab 集成服务器，提供多种 GitLab RESTful API 工具，支持 Claude、Smithery 等平台集成。该服务主要用于与 GitLab 进行交互，包括搜索用户项目、管理合并请求、添加评论等功能。
View on GitHub
Overview
基本能力
产品定位
mcp-server-gitlab 是一个 GitLab 集成服务器，旨在通过 MCP 框架提供多种 GitLab RESTful API 工具，方便用户与 GitLab 进行交互。
核心功能
- GitlabSearchUserProjectsTool：根据用户名搜索用户及其活跃项目
- GitlabGetUserTasksTool：获取当前用户的待办任务
- GitlabSearchProjectDetailsTool：搜索项目及详细信息
- GitlabCreateMRCommentTool：为合并请求添加评论
- GitlabAcceptMRTool：接受并合并合并请求
- GitlabUpdateMRTool：更新 Merge Request 的指派人、评审人、标题、描述、标签
- GitlabCreateMRTool：创建新的 Merge Request，支持指派 assignee 和 reviewers
- GitlabRawApiTool：自定义调用任意 GitLab API
适用场景
- 开发团队需要自动化管理 GitLab 项目
- 需要快速搜索 GitLab 用户或项目信息
- 需要批量处理合并请求或任务
- 需要集成 GitLab API 到其他平台（如 Claude、Smithery）
工具列表
- GitlabSearchUserProjectsTool：搜索用户及其活跃项目
- GitlabGetUserTasksTool：获取当前用户的待办任务
- GitlabSearchProjectDetailsTool：搜索项目及详细信息
- GitlabCreateMRCommentTool：为合并请求添加评论
- GitlabAcceptMRTool：接受并合并合并请求
- GitlabUpdateMRTool：更新 Merge Request 的指派人、评审人、标题、描述、标签
- GitlabCreateMRTool：创建新的 Merge Request
- GitlabRawApiTool：自定义调用任意 GitLab API
常见问题解答
- 如何配置 GitLab API URL 和 Token？
通过环境变量
GITLAB_API_URL和GITLAB_TOKEN进行配置。 - 如何集成到 Claude 桌面客户端？
在配置文件中添加
mcpServers配置项，并指定@zephyr-mcp/gitlab的启动命令。
使用教程
使用依赖
确保已安装 Node.js 和 Bun 运行时环境。
安装教程
# 安装依赖
bun install
# 构建项目
bun run build
# 启动服务
bun run start
环境变量配置
GITLAB_API_URL=https://your-gitlab-instance.com
GITLAB_TOKEN=your_access_token
调试方式
启动服务后，可以通过调用工具 API 进行调试，具体示例见 USAGE.md。
集成方式
Claude 桌面客户端
在配置文件中添加：
{
"mcpServers": {
"@zephyr-mcp/gitlab": {
"command": "npx",
"args": ["-y", "@zephyr-mcp/[email protected]"]
}
}
}