GitLab MCP 服务器是一个基于 Model Context Protocol (MCP) 的后端应用,它允许大型语言模型 (LLM) 客户端通过标准化的工具调用方式与 GitLab 平台进行交互,获取仓库、群组、用户信息等数据。

主要功能点

该服务器提供一系列工具,使 LLM 能够:

  • 列出项目: 获取用户可访问的 GitLab 项目列表,支持按所有者或星标过滤。
  • 列出群组: 获取用户可访问的 GitLab 群组列表。
  • 列出群组项目: 获取指定 GitLab 群组下的所有项目。
  • 获取用户信息: 获取当前认证用户的详细信息。
  • 搜索仓库: 根据关键词搜索 GitLab 仓库。
  • 获取仓库详情: 获取指定 GitLab 仓库的详细信息(包括语言、分支数、标签数等)。

安装步骤

  1. 确保你的系统已安装 Python 和 'uv' 包管理器。
  2. 打开终端,运行以下命令安装 GitLab MCP 服务器:
    uv pip install gitlab-mcp-server

服务器配置

MCP 客户端(如 Claude Desktop 等支持 MCP 的应用)需要以下配置信息来启动并连接到 GitLab MCP 服务器。请将以下 JSON 配置结构添加到客户端的 MCP 服务器设置中:

{
  "mcpServers": {
    "GitLab": {
      "command": "uvx",
      "args": [
        "gitlab-mcp-server"
      ],
      "env": {
        "GITLAB_TOKEN": "<你的 GitLab 个人访问令牌>",
        "GITLAB_URL": "https://gitlab.com"
      }
    }
  }
}
  • '"GitLab"': 服务器在客户端中显示的名称,你可以自定义。
  • '"command"': 启动服务器进程的命令,这里使用 'uvx' 运行安装的包。
  • '"args"': 传递给 'command' 的参数,指定运行 'gitlab-mcp-server'。
  • '"env"': 启动服务器进程时需要设置的环境变量。
    • '"GITLAB_TOKEN"': 必须设置为你的 GitLab 个人访问令牌。该令牌需要至少 'read_api' 范围权限。你可以在 GitLab 的“用户设置”->“访问令牌”中创建。
    • '"GITLAB_URL"': (可选) 如果你使用的是自托管的 GitLab 实例,请将此值更改为你的实例 URL (例如 'https://your.gitlab.instance.com')。默认值为 'https://gitlab.com'。

基本使用方法

  1. 完成安装和服务器配置。
  2. 启动支持 MCP 的 LLM 客户端。
  3. 客户端将根据你的配置自动启动 GitLab MCP 服务器。
  4. LLM 通过 MCP 协议发现并调用服务器提供的工具。你可以直接向 LLM 提问关于你在 GitLab 中的项目、群组或用户信息的问题,LLM 将根据需要调用相应的工具来获取数据并回答你。

信息

分类

开发者工具