GitLab

GitLab

支持项目管理的GitLab API

GitHub
Created Bymodelcontextprotocolmodelcontextprotocol

简介

GitLab MCP 服务器提供了 GitLab API 的简便访问，支持项目管理、文件操作和版本控制等功能。

设置步骤

1. 创建个人访问令牌

  1. 前往 GitLab 用户设置 > 访问令牌
  2. 选择所需权限：
    • api (完整访问)
    • read_api (只读访问)
    • read_repository 和 write_repository (仓库操作)
  3. 创建并保存令牌

2. 配置 Claude Desktop

将以下配置添加到 claude_desktop_config.json：

Docker 配置

{
  "mcpServers": { 
    "gitlab": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "GITLAB_PERSONAL_ACCESS_TOKEN",
        "-e", "GITLAB_API_URL",
        "mcp/gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>",
        "GITLAB_API_URL": "https://gitlab.com/api/v4"
      }
    }
  }
}

NPX 配置

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>",
        "GITLAB_API_URL": "https://gitlab.com/api/v4"
      }
    }
  }
}

主要功能

  • 自动创建分支：操作时自动创建不存在的分支
  • 保留 Git 历史：不进行强制推送，维护正确的提交历史
  • 批量操作：支持单个和多个文件的操作

核心工具

工具功能
create_or_update_file创建或更新单个文件
push_files在单次提交中推送多个文件
search_repositories搜索 GitLab 项目
create_repository创建新的 GitLab 项目
get_file_contents获取文件或目录内容
create_issue创建新的问题
create_merge_request创建新的合并请求
fork_repository叉一个项目
create_branch创建新分支

环境变量

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

许可证

MIT 许可证