自定义 GitLab MCP 服务器

一个自定义实现的 GitLab MCP (模型上下文协议) 服务器，用于与 Claude 和其他符合 MCP 规范的 AI 助手集成。

概述

此 MCP 服务器提供与 GitLab 仓库的无缝集成，允许 AI 助手：

• 搜索 GitLab 仓库
• 获取文件内容
• 创建或更新文件
• 在单个提交中推送多个文件
• 创建 issue 和 merge request
• Fork 仓库
• 创建分支

修复的实现

此自定义实现修复了标准 GitLab MCP 服务器实现中存在的 schema 验证问题，特别是针对 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 个人访问令牌：
  • 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	创建一个新的 issue
create_merge_request	创建一个新的 merge request
fork_repository	Fork 一个项目
create_branch	创建一个新的分支

许可证

MIT