🚀 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 文件。