Custom GitLab MCP Server

Custom GitLab MCP Server

site icon
2025.03.07 0
JavaScriptGitLab 集成代码管理团队协作开发效率交流协作
Custom GitLab MCP Server 是一个自定义实现的 GitLab MCP(Model Context Protocol)服务器,用于与 Claude 和其他符合 MCP 标准的 AI 助手集成。该服务器提供了与 GitLab 仓库的无缝集成,支持搜索仓库、获取文件内容、创建或更新文件、推送多个文件、创建问题和合并请求等功能。
View on GitHub

Overview

基本能力

产品定位

Custom GitLab MCP Server 是一个用于与 GitLab 仓库集成的 MCP 服务器,旨在为 AI 助手提供丰富的 GitLab 操作能力。

核心功能

  • 搜索 GitLab 仓库
  • 获取文件内容
  • 创建或更新文件
  • 推送多个文件(单次提交)
  • 创建问题和合并请求
  • 创建新仓库
  • 创建分支

适用场景

  • AI 助手与 GitLab 仓库的交互
  • 自动化代码管理
  • 团队协作开发

工具列表

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

使用教程

使用依赖

  • Node.js (v14 或更高版本)
  • GitLab 个人访问令牌(需包含以下权限):
  • api(完整 API 访问)
  • read_api(只读访问)
  • read_repositorywrite_repository(仓库操作)

安装教程

  1. 克隆仓库
  2. 安装依赖: bash npm install
  3. 在 Claude 设置文件或 Claude Desktop 配置文件中配置: json { "mcpServers": { "github.com/modelcontextprotocol/servers/tree/main/src/gitlab": { "command": "node", "args": [ "/path/to/custom-gitlab-server/index.js" ], "env": { "GITLAB_PERSONAL_ACCESS_TOKEN": "your-gitlab-token", "GITLAB_API_URL": "https://your-gitlab-instance/api/v4" } } } }

调试方式

安装完成后,可以通过运行服务器并测试各个工具功能来进行调试。确保环境变量和权限设置正确。

许可证

该项目遵循 MIT 开源许可条款。