GitLab MCP Server

通过 MCP（Model Context Protocol） 协议让 Claude 操作 GitLab API 的服务器。

---

功能

共 15 个工具，覆盖 GitLab 核心操作：

分类	工具	说明
服务器信息	get_mcp_server_version	返回服务器版本信息
Issues	create_issue	创建 Issue
Issues	get_issue	获取 Issue 详情
Merge Requests	create_merge_request	创建 MR
Merge Requests	get_merge_request	获取 MR 详情
Merge Requests	get_merge_request_commits	获取 MR 提交列表
Merge Requests	get_merge_request_diffs	获取 MR 差异
Merge Requests	get_merge_request_pipelines	获取 MR 关联 Pipeline
Pipelines	get_pipeline_jobs	获取 Pipeline Job 列表
Pipelines	manage_pipeline	列出/创建/重试/取消/删除 Pipeline
工作项	create_workitem_note	为工作项创建评论（GraphQL）
工作项	get_workitem_notes	获取工作项评论列表（GraphQL）
搜索	search	全局/群组/项目搜索
搜索	search_labels	搜索标签
搜索	semantic_code_search	语义代码搜索（需 GitLab Duo Enterprise）

---

环境要求

• Node.js >= 18.0.0
• GitLab Personal Access Token（需要 api scope）

---

安装与配置

环境变量

变量名	必填	说明
GITLAB_TOKEN	是	GitLab Personal Access Token
GITLAB_URL	否	GitLab 实例地址，默认 https://gitlab.com

方式一：npx（推荐，无需本地安装）

Claude Code 命令行添加：

claude mcp add --scope project gitlab -- npx @nilsir/mcp-server-gitlab

或手动配置 .mcp.json：

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": ["@nilsir/mcp-server-gitlab"],
      "env": {
        "GITLAB_TOKEN": "your_token_here",
        "GITLAB_URL": "https://gitlab.example.com"
      }
    }
  }
}

方式二：从源码构建

git clone https://github.com/nilsir/mcp-server-gitlab.git
cd mcp-server-gitlab
npm install && npm run build

Claude Code 命令行添加：

claude mcp add --scope project gitlab -- node /path/to/dist/index.js

或手动配置 .mcp.json：

{
  "mcpServers": {
    "gitlab": {
      "command": "node",
      "args": ["/path/to/mcp-server-gitlab/dist/index.js"],
      "env": {
        "GITLAB_TOKEN": "your_token_here",
        "GITLAB_URL": "https://gitlab.example.com"
      }
    }
  }
}

---

开发

# 安装依赖
npm install

# 运行测试（监听模式）
npm test

# 单次运行测试（37 个测试）
npm run test:run

# 编译 TypeScript
npm run build

# 开发模式（无需编译，直接运行 TypeScript）
npm run dev

# 本地调试（使用 MCP Inspector）
npx @modelcontextprotocol/inspector node dist/index.js

---

技术栈

• 运行时：TypeScript + Node.js (ESM)
• MCP SDK：@modelcontextprotocol/sdk ^1.12.0
• 参数校验：Zod
• 测试框架：Vitest
• HTTP 客户端：原生 fetch（无额外依赖）

---

License

MIT