返回 MCP 目录
public公开dns本地运行

gitlab-mcp-server

GitLab MCP Server是一个基于Model Context Protocol (MCP)的服务,提供与GitLab API的无缝集成,支持开发者及AI工具在GitLab生态系统中实现高级自动化和交互功能。

article

README

🚀 关于 GitLab

GitLab 是一款强大的代码托管和协作平台,它提供了丰富的功能,如版本控制、问题跟踪、持续集成等,能极大提升团队的开发效率。

🚀 快速开始

📦 安装

要获取 GitLab,请按照以下步骤操作:

  1. 访问 GitLab 下载页面
  2. 根据你的操作系统选择合适的版本进行下载。
  3. 按照安装向导完成安装过程。
  4. 打开 GitLab 并开始使用。

🛠️ GitLab 自托管实例

如果你有自托管的 GitLab 实例,请按照以下步骤操作:

  1. 访问 GitLab 安装文档
  2. 根据你的操作系统和环境选择合适的安装方法。
  3. 配置 GitLab 的基本设置,包括 URL 和认证方式。
  4. 启动 GitLab 服务并访问你的 GitLab 实例。

💻 使用示例

🌟 动态工具发现

动态工具发现功能允许你根据需要自定义工具的使用体验。以下是实现步骤:

🔨 基础用法

使用命令行参数:

./gitlab-mcp-server stdio --dynamic-toolsets

🔧 高级用法

  • 使用环境变量
export GITLAB_DYNAMIC_TOOLSETS=1
./gitlab-mcp-server stdio
  • 使用 Docker
docker run -i --rm \
  -e GITLAB_TOKEN=... \
  -e GITLAB_DYNAMIC_TOOLSETS=1 \
  your-docker-registry/gitlab-mcp-server:latest # 重要:更新镜像路径!

🌐 i18n / 覆盖描述

为了实现国际化或自定义描述,可以按照以下步骤操作:

🔨 基础用法

在与服务器二进制文件相同目录下创建 gitlab-mcp-server-config.json 文件,并添加自定义翻译内容:

{
  "TOOL_GET_ISSUE_DESCRIPTION": "获取 GitLab 问题的详细信息。",
  "TOOL_CREATE_MERGE_REQUEST_USER_TITLE": "新建 MR"
}

🔧 高级用法

使用 --export-translations 标志生成或更新配置文件:

./gitlab-mcp-server --export-translations 
# 这将创建/更新 gitlab-mcp-server-config.json 文件

🤝 贡献与许可证

贡献者欢迎!请参考 CONTRIBUTING.md 了解详细信息。

此项目采用 MIT License 发布。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端