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（创建问题）

   • 功能：创建新Issue
   • 输入：
     • project_id（字符串）：项目ID或URL编码路径
     • title（字符串）：Issue标题
     • description（可选字符串）：Issue描述
     • assignee_ids（可选数组）：指派用户ID
     • labels（可选数组）：标签列表
     • milestone_id（可选数字）：里程碑ID
   • 返回：新建Issue详情

7. create_merge_request（创建合并请求）

   • 功能：创建新合并请求（MR）
   • 输入：
     • project_id（字符串）：项目ID或URL编码路径
     • title（字符串）：MR标题
     • description（可选字符串）：MR描述
     • source_branch（字符串）：源分支（含变更）
     • target_branch（字符串）：目标分支（合并至）
     • draft（可选布尔值）：是否作为草稿MR
     • allow_collaboration（可选布尔值）：允许上游成员提交
   • 返回：新建合并请求详情

8. fork_repository（ fork项目）

   • 功能：Fork项目到指定命名空间
   • 输入：
     • project_id（字符串）：原项目ID或URL编码路径
     • namespace（可选字符串）：目标命名空间
   • 返回：Fork后的项目详情

9. create_branch（创建分支）

   • 功能：创建新分支
   • 输入：
     • project_id（字符串）：项目ID或URL编码路径
     • branch（字符串）：新分支名称
     • ref（可选字符串）：源分支/提交（默认基于主分支）
   • 返回：新建分支引用

配置步骤

1. 创建GitLab个人访问令牌（PAT）
   • 前往GitLab 用户设置 > 访问令牌（User Settings > Access Tokens）
   • 选择所需权限范围：
     • api：完整API访问
     • read_api：只读访问
     • read_repository + write_repository：仓库操作（读写）
   • 生成令牌并安全保存