gitlab-mcp

🚀 GitLab MCP 服务器

GitLab MCP 服务器是用于与 GitLab 进行交互的工具，可实现仓库管理、分支操作、文件操作等功能，为开发者提供便捷的 GitLab 管理体验。

🚀 快速开始

安装

使用 uv

git clone https://gitlab.com/gitlab-org/mcp.git
cd mcp
uv app:start

使用 pip

pip install gitlab-mcp
mcp-server run

配置

环境变量

• GITLAB_API_URL: GitLab 实例的 URL，默认为 https://gitlab.com。
• GITLAB_PRIVATE_TOKEN: 用于身份验证的私人访问令牌。

MCP 配置文件

development:
  enable: true
  features:
    file_operations: true
    issue_management: true

📦 安装指南

使用 uv

通过 uv 可以快速克隆项目并启动应用。

git clone https://gitlab.com/gitlab-org/mcp.git
cd mcp
uv app:start

使用 pip

使用 pip 可以直接安装 gitlab-mcp 并启动服务。

pip install gitlab-mcp
mcp-server run

📚 详细文档

项目结构

src/
├── api/           # API交互层
│   ├── controllers/      # 控制器逻辑
│   └── models/         # 数据模型定义
├── core/          # 核心业务逻辑
│   ├── commands/       # 业务命令处理
│   └── validators/     # 数据验证规则
└── infra/         # 基础设施配置
    ├── config/        # 应用配置文件
    └── dependencies/  # 第三方依赖管理

工具

仓库管理

• create_repository: 创建新存储库。
• delete_repository: 删除现有存储库。

分支操作

• list_branches: 列出所有分支。
• create_branch: 创建新分支。
• delete_branch: 删除指定分支。

文件操作

• upload_file: 上传文件到存储库。
• download_file: 下载指定文件。
• update_file_contents: 更新现有文件内容。
• delete_file: 删除指定文件。

🔧 技术细节

故障排除

常见问题

• 身份验证错误: 确保 GITLAB_PRIVATE_TOKEN 有效且具有正确权限。
• 服务未启动: 检查安装日志或重新运行安装命令。

📄 许可证

本项目遵循 MIT 许可证，具体内容请参阅 LICENSE 文件。