GitLab MCP Server (noqta-gitlab-server)
2025.04.18
0
JavaScriptGitLab 集成项目管理代码协作开发效率交流协作
GitLab MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，专门用于与 GitLab API 进行交互。它允许 AI 助手（如通过 MCP 集成的 Claude）通过自然语言命令直接在 GitLab 上执行各种操作，包括搜索仓库、管理问题、创建分支等。
View on GitHub
Overview
基本能力
产品定位
GitLab MCP Server 旨在为开发者和团队提供一个高效的工具，通过 AI 助手简化 GitLab 上的项目管理、代码协作和问题跟踪流程。
核心功能
- 仓库管理：搜索仓库、获取仓库详情、创建新仓库。
- 问题管理：列出问题、获取问题详情、创建和更新问题、添加评论。
- 分支和合并请求：创建分支、创建合并请求、添加合并请求评论。
- 用户管理：搜索用户。
适用场景
- 团队协作：通过 AI 助手快速管理项目问题和合并请求。
- 开发效率：自动化执行常见的 GitLab 操作，减少手动操作时间。
- 项目管理：快速搜索和筛选项目问题，提高项目管理效率。
工具列表
search_repositories：按名称搜索 GitLab 项目。get_project_from_git_url：通过 git 远程 URL 获取 GitLab 项目详情。list_issues：列出特定项目的所有问题（可按状态、标签、分配人等筛选）。get_my_issues：列出分配给或由认证用户创建的所有问题。get_issue：获取特定问题的详情。create_issue_note：为特定问题添加评论。update_issue：更新问题的属性（如描述、标签、状态）。create_branch：从指定引用创建新分支。create_issue：在项目中创建新问题。create_merge_request：创建新的合并请求。list_issue_notes：列出特定问题的所有评论。create_merge_request_note：为特定合并请求添加评论。search_user：按邮箱或用户名搜索 GitLab 用户。create_repository：在用户或组命名空间下创建新 GitLab 项目。
常见问题解答
- 如何获取 GitLab 个人访问令牌？
在 GitLab 个人设置 -> 访问令牌中创建，需包含
api和read_api权限。 - 如何配置自托管的 GitLab 实例？
在
.env文件中设置GITLAB_API_URL为自托管实例的 API 端点。 - 如何调试？
使用
npm run inspector启动调试工具，查看 MCP 消息和服务器日志。
使用教程
使用依赖
- Node.js（推荐 LTS 版本）
- npm（通常随 Node.js 一起安装）
- GitLab 账户（gitlab.com 或自托管）
- GitLab 个人访问令牌（需
api和read_api权限）
安装教程
- 克隆仓库
bash git clone https://github.com/nooqta/noqta-gitlab-server.git cd noqta-gitlab-server - 安装依赖
bash npm install - 配置环境变量
bash cp .env.example .env编辑.env文件，设置GITLAB_PERSONAL_ACCESS_TOKEN和GITLAB_API_URL（可选）。 - 构建服务器
bash npm run build
调试方式
- 直接运行
bash node build/index.js - 使用 npx
bash npx @nooqta/gitlab-mcp-server - 调试工具
bash npm run inspector