remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Allows interaction with GitLab repositories including project management, file operations, branch creation, issue tracking, merge request management, repository forking, and project search capabilities through the GitLab API

GitLab MCP 服务器

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

特征

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

工具

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

{
  "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" // Optional, for self-hosted instances
      }
    }
  }
}

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" // Optional, for self-hosted instances
      }
    }
  }
}

建造

Docker 构建：

docker build -t vonwig/gitlab:mcp -f src/gitlab/Dockerfile .

环境变量

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

执照

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools