Zephyrdeng MCP Server Gitlab

🚀 mcp-gitlab MCP 服務器

mcp-gitlab 是基於 Model Context Protocol (MCP) 框架構建的 GitLab 集成服務器，它提供了多種 GitLab RESTful API 工具，支持與 Claude、Smithery 等平臺集成，能幫助用戶更便捷地操作 GitLab。

🚀 快速開始

安裝依賴

bun install

構建項目

bun run build

啟動服務

bun run start

✨ 主要特性

• GitlabSearchUserProjectsTool：根據用戶名搜索用戶及其活躍項目。
• GitlabGetUserTasksTool：獲取當前用戶的待辦任務。
• GitlabSearchProjectDetailsTool：搜索項目及詳細信息。
• GitlabCreateMRCommentTool：為合併請求添加評論。
• GitlabAcceptMRTool：接受併合併合並請求。
• GitlabUpdateMRTool：更新 Merge Request 的指派人、評審人、標題、描述、標籤。
• GitlabCreateMRTool：創建新的 Merge Request，支持指派 assignee 和 reviewers。
• GitlabRawApiTool：自定義調用任意 GitLab API。

📦 安裝指南

環境變量配置

GITLAB_API_URL=https://your-gitlab-instance.com
GITLAB_TOKEN=your_access_token

配置參數說明：

• GITLAB_API_URL：GitLab API 的基礎 URL。
• GITLAB_TOKEN：用於驗證 GitLab API 請求的訪問令牌。

💻 使用示例

詳見 USAGE.md，其中包含每個工具的參數示例。

📚 詳細文檔

項目結構

src/
├── server/
│   └── GitlabMCPServer.ts          # MCP 服務器入口
├── tools/
│   ├── GitlabAcceptMRTool.ts
│   ├── GitlabCreateMRCommentTool.ts
│   ├── GitlabGetUserTasksTool.ts
│   ├── GitlabRawApiTool.ts
│   ├── GitlabSearchProjectDetailsTool.ts
│   ├── GitlabSearchUserProjectsTool.ts
│   └── gitlab/
│       ├── FieldFilterUtils.ts
│       ├── GitlabApiClient.ts
│       └── GitlabApiTypes.ts
├── utils/
│   ├── is.ts
│   └── sensitive.ts
smithery.json                      # Smithery 配置
USAGE.md                          # 使用示例
package.json
tsconfig.json

集成方式

Claude 桌面客戶端

在配置文件中添加：

{
  "mcpServers": {
    "@zephyr-mcp/gitlab": {
      "command": "npx",
      "args": ["-y", "@zephyr-mcp/gitlab@0.1.0"]
    }
  }
}

配置參數：

• GITLAB_API_URL：GitLab API 的基礎 URL。
• GITLAB_TOKEN：用於驗證 GitLab API 請求的訪問令牌。

🔗 相關鏈接

• fastmcp
• Smithery
• GitLab API

狀態徽章