Custom GitLab MCP Server

自定义 GitLab MCP 服务

自定义实现的 GitLab MCP（Model Context Protocol）服务，可与 Claude 和其他兼容 MCP 的 AI 助手集成。

概述

此 MCP 服务可与 GitLab 仓库无缝集成，让 AI 助手能够：

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

修复内容

此自定义实现修复了标准 GitLab MCP 服务实现中存在的架构验证问题，特别是 search_repositories 工具的问题。

安装

1. 克隆此仓库
2. 安装依赖项：

   npm install
   

3. 在 Claude 设置文件或 Claude Desktop 配置文件中进行配置：

   {
     "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"
         }
       }
     }
   }
   

前置条件

• Node.js（v14 或更高版本）
• 具有相应权限范围的 GitLab Personal Access Token：
  • api，用于完整的 API 访问权限
  • read_api，用于只读访问权限
  • read_repository 和 write_repository，用于仓库操作

可用工具

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

许可证

MIT