基本能力
产品定位
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 安装（推荐）
bash
npm install @yoda.digital/gitlab-mcp-server
从源码安装
bash
git clone https://github.com/yoda-digital/mcp-gitlab-server.git
cd mcp-gitlab-server
npm install
npm run build
调试方式
使用 stdio 传输（默认）
bash
export GITLAB_PERSONAL_ACCESS_TOKEN=your_token_here
npm start
使用 SSE 传输
bash
export GITLAB_PERSONAL_ACCESS_TOKEN=your_token_here
export USE_SSE=true
export PORT=3000
npm start
使用 npx
bash
GITLAB_PERSONAL_ACCESS_TOKEN=your_token_here npx @yoda.digital/gitlab-mcp-server
