GitLab MCP Server

GitLab MCP 服务器

GitLab API 的 MCP 服务器，支持项目管理、文件操作等。

特征

• 自动创建分支：创建/更新文件或推送更改时，如果分支不存在，则会自动创建分支
• 全面的错误处理：针对常见问题的清晰错误消息
• Git 历史记录保存：操作无需强制推送即可维护正确的 Git 历史记录
• 批量操作：支持单文件和多文件操作

工具

1. create_or_update_file
   • 创建或更新项目中的单个文件
   • 输入：
     • project_id （字符串）：项目 ID 或 URL 编码路径
     • file_path （字符串）：创建/更新文件的路径
     • content （字符串）：文件的内容
     • commit_message （字符串）：提交消息
     • branch （字符串）：创建/更新文件的分支
     • previous_path （可选字符串）：要移动/重命名的文件的路径
   • 返回：文件内容和提交详细信息
2. push_files
   • 在一次提交中推送多个文件
   • 输入：
     • project_id （字符串）：项目 ID 或 URL 编码路径
     • branch （字符串）：要推送到的分支
     • files （数组）：要推送的文件，每个文件都有file_path和content
     • commit_message （字符串）：提交消息
   • 返回：更新的分支参考
3. search_repositories
   • 搜索 GitLab 项目
   • 输入：
     • search （字符串）：搜索查询
     • page （可选数字）：分页的页码
     • per_page （可选数字）：每页结果数（默认 20）
   • 返回：项目搜索结果
4. create_repository
   • 创建新的 GitLab 项目
   • 输入：
     • name （字符串）：项目名称
     • description （可选字符串）：项目描述
     • visibility （可选字符串）：“private”、“internal”或“public”
     • initialize_with_readme (可选布尔值): 使用 README 初始化
   • 返回：创建的项目详细信息
5. get_file_contents
   • 获取文件或目录的内容
   • 输入：
     • project_id （字符串）：项目 ID 或 URL 编码路径
     • file_path （字符串）：文件/目录的路径
     • ref （可选字符串）：从中获取内容的分支/标签/提交
   • 返回：文件/目录内容
6. create_issue
   • 创建新问题
   • 输入：
     • project_id （字符串）：项目 ID 或 URL 编码路径
     • title （字符串）：问题标题
     • description （可选字符串）：问题描述
     • assignee_ids （可选数字[]）：要分配的用户 ID
     • labels （可选字符串[]）：要添加的标签
     • milestone_id （可选数字）：里程碑 ID
   • 返回：创建问题详情
7. create_merge_request
   • 创建新的合并请求
   • 输入：
     • project_id （字符串）：项目 ID 或 URL 编码路径
     • title （字符串）：MR 标题
     • description （可选字符串）：MR 描述
     • source_branch （字符串）：包含更改的分支
     • target_branch （字符串）：要合并的分支
     • draft （可选布尔值）：创建为 MR 草稿
     • allow_collaboration （可选布尔值）：允许上游成员提交
   • 返回：创建的合并请求详细信息
8. fork_repository
   • 派生一个项目
   • 输入：
     • project_id （字符串）：项目 ID 或 URL 编码路径
     • namespace （可选字符串）：要分叉到的命名空间
   • 返回：分叉项目详细信息
9. create_branch
   • 创建新分支
   • 输入：
     • project_id （字符串）：项目 ID 或 URL 编码路径
     • branch （字符串）：新分支的名称
     • ref （可选字符串）：新分支的源分支/提交
   • 返回：创建的分支引用

设置

个人访问令牌

创建具有适当权限的 GitLab 个人访问令牌：

• 前往 GitLab 中的“用户设置”>“访问令牌”
• 选择所需的范围：
  • api用于完整 API 访问
  • read_api用于只读访问
  • read_repository和write_repository用于存储库操作
• 创建令牌并安全保存

与 Claude Desktop 一起使用

将以下内容添加到您的claude_desktop_config.json中：

Docker

NPX

与 VS Code 一起使用

为了快速安装，请使用下面的一键安装按钮之一...

如需手动安装，请将以下 JSON 块添加到 VS Code 中的“用户设置 (JSON)”文件中。您可以按下Ctrl + Shift + P并输入Preferences: Open User Settings (JSON)来执行此操作。

或者，您可以将其添加到工作区中名为.vscode/mcp.json的文件中。这样您就可以与其他人共享该配置。

请注意.vscode/mcp.json文件中不需要mcp键。

Docker

NPX

建造

Docker 构建：

环境变量

• GITLAB_PERSONAL_ACCESS_TOKEN ：您的 GitLab 个人访问令牌（必需）
• GITLAB_API_URL ：GitLab API 的基本 URL（可选，默认为https://gitlab.com/api/v4 ）

执照

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但须遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。