GitLab MCP Server

基本能力

产品定位

GitLab MCP Server 是一个专为 GitLab 设计的 MCP 服务器，旨在通过 AI 助手自动化和管理 GitLab 资源，提升开发效率和团队协作。

核心功能

• 全面的 GitLab API 集成：支持仓库、问题、合并请求、Wiki 等操作。
• 多种传输方式：支持 stdio 和 Server-Sent Events (SSE)。
• 标准化响应格式：统一的翻页和响应结构。
• 强类型支持：基于 MCP SDK 的类型安全设计。
• 完整的文档：所有可用工具的示例。

适用场景

• AI 驱动的开发工作流：AI 助手与 GitLab 仓库交互。
• 自动化问题与合并请求管理：简化开发流程。
• Wiki 管理：自动化文档更新。
• 团队协作：集成 AI 助手到团队工作流中。

工具列表

• 仓库管理：搜索、创建、分叉仓库。
• 文件操作：读取、创建、更新文件。
• 分支操作：创建和管理分支。
• 问题跟踪：创建、列出、筛选问题。
• 合并请求：创建、列出、审查合并请求。
• 成员管理：列出和管理项目/组成员。
• Wiki 管理：支持项目和组的 Wiki 及附件。

常见问题解答

• 如何启用只读模式：设置 GITLAB_READ_ONLY_MODE=true。
• 如何配置环境变量：需设置 GITLAB_PERSONAL_ACCESS_TOKEN 和 GITLAB_API_URL。

使用教程

使用依赖

• Node.js 16+
• npm 7+
• GitLab 账号及个人访问令牌

安装教程

从 npm 安装（推荐）

npm install @yoda.digital/gitlab-mcp-server

从源码安装

git clone https://github.com/yoda-digital/mcp-gitlab-server.git
cd mcp-gitlab-server
npm install
npm run build

调试方式

使用 stdio 传输（默认）

export GITLAB_PERSONAL_ACCESS_TOKEN=your_token_here
npm start

使用 SSE 传输

export GITLAB_PERSONAL_ACCESS_TOKEN=your_token_here
export USE_SSE=true
export PORT=3000
npm start

使用 npx

GITLAB_PERSONAL_ACCESS_TOKEN=your_token_here npx @yoda.digital/gitlab-mcp-server

许可证

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