MCP Server Gitlab

🚀 mcp-gitlab MCP 服務器（中文版）

mcp-gitlab MCP 服務器基於 fastmcp 框架構建，是一個 GitLab 集成服務器。它提供了豐富的 GitLab RESTful API 工具，還支持與 Claude、Smithery 等平臺集成，能有效提升開發效率和項目管理的便捷性。

✨ 主要特性

• GitlabSearchUserProjectsTool：可通過用戶名搜索用戶及其活躍項目。
• GitlabGetUserTasksTool：用於獲取當前用戶的待處理任務。
• GitlabSearchProjectDetailsTool：能夠搜索項目及詳細信息。
• GitlabCreateMRCommentTool：支持向合併請求添加評論。
• GitlabAcceptMRTool：可接受併合併合並請求。
• GitlabUpdateMRTool：能更新合併請求的負責人、審查人、標題、描述和標籤。
• GitlabCreateMRTool：可以創建新的合併請求，還支持指定負責人和審查人。
• GitlabRawApiTool：允許使用自定義參數調用任意 GitLab API。

🚀 快速開始

以下是啟動服務器的步驟：

# 安裝依賴
bun install

# 構建項目
bun run build

# 啟動服務器
bun run start

📦 安裝指南

環境變量配置

在項目運行前，需要配置一些環境變量：

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

# 可選：提供用戶名到用戶 ID 的映射（JSON 字符串）
# 這可以減少 API 調用次數，特別是在頻繁引用相同用戶時
# 示例：{"username1": 123, "username2": 456}
GITLAB_USER_MAPPING={"username1": 123, "username2": 456}

# 可選：提供項目名到項目 ID 的映射（JSON 字符串）
# 項目 ID 可以是數字或字符串（例如："group/project"）
# 這可以減少 API 調用並確保正確使用項目
# 示例：{"project-name-a": 1001, "group/project-b": "group/project-b"}
GITLAB_PROJECT_MAPPING={"project-name-a": 1001, "group/project-b": "group/project-b"}

💻 使用示例

詳細示例請參見 USAGE.md。

📚 詳細文檔

項目結構

src/
├── server/
│   └── GitlabMCPServer.ts          # MCP 服務器入口文件
├── tools/
│   ├── GitlabAcceptMRTool.ts
│   ├── GitlabCreateMRCommentTool.ts
│   ├── GitlabGetUserTasksTool.ts
│   ├── GitlabRawApiTool.ts
│   ├── GitlabCreateMRTool.ts
│   └── GitlabUpdateMRTool.ts
└── README.md                      # 項目文檔

相關鏈接

• fastmcp
• Smithery
• GitLab API