GitLab MCP 服务器指南

简介

GitLab MCP 服务器是一个集成在 GitLab 中的工具，旨在通过 Model Context Protocol（MCP）提供与各种开发工具和服务的交互。它允许开发者直接从代码仓库中获取信息，并与其他服务进行通信。

特性/可用工具

该服务器提供了以下功能：

• 代码仓库访问：可以直接从 GitLab 仓库获取代码和相关信息。
• 集成开发环境支持：支持与 IDE（如 VS Code、IntelliJ IDEA 等）的无缝连接。
• 问题跟踪：能够查看和管理 GitLab 项目中的问题和合并请求。
• 团队协作：促进团队成员之间的协作，提供实时反馈和代码审查。

先决条件

在运行 GitLab MCP 服务器之前，请确保以下环境配置：

1. 操作系统要求：

   • 支持 Node.js 的版本（推荐使用 LTS 版本）。
   • Windows、macOS 或 Linux 系统均可支持。

2. 工具安装：

   • 安装 Node.js 和 npm。
   • 确保系统上已安装 Git。

3. 环境变量配置：

   • 配置 GITLAB_PERSONAL_ACCESS_TOKEN：这是用于与 GitLab API 通信的访问令牌，需在 GitLab 账户设置中生成。
   • 可选配置 GITLAB_API_URL：若使用自托管的 GitLab 实例，需指定其 API 地址。

安装与设置

克隆仓库

git clone https://github.com/yourusername/gitlab-mcp-server.git

安装依赖

进入克隆后的项目目录，安装所需的依赖：

cd gitlab-mcp-server
npm install

配置环境变量

创建一个 .env 文件，并添加以下内容：

GITLAB_PERSONAL_ACCESS_TOKEN=your_token_here
GITLAB_API_URL=https://gitlab.example.com  # 如果使用自托管，请填写此地址

构建服务器

构建项目并设置为可执行：

npm run build

运行服务器

直接运行

使用 Node.js 运行构建后的文件：

node build/index.js

使用 npx

若已全局安装，可以直接通过 npx 运行：

npx @yourusername/gitlab-mcp-server

集成（例如 Claude Desktop）

在 claude_desktop_config.json 中添加以下配置：

使用 npx：

{
  "mcpServers": {
    "@yourusername/gitlab-mcp-server": {
      "command": "npx",
      "args": ["-y", "@yourusername/gitlab-mcp-server"],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "...",
        "GITLAB_API_URL": "..."
      }
    }
  }
}

使用本地构建：

{
  "mcpServers": {
    "@yourusername/gitlab-mcp-server": {
      "command": "/full/path/to/your/custom-gitlab-server/build/index.js",
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "...",