mcp-gitlab MCP 服务器 (英文)
基于 fastmcp 框架构建的 GitLab 集成服务器，提供丰富的 GitLab RESTful API 工具。支持与 Claude、Smithery 等平台集成。
特征
GitlabSearchUserProjectsTool ：按用户名搜索用户及其活跃项目
GitlabGetUserTasksTool ：获取当前用户的待处理任务
GitlabSearchProjectDetailsTool ：搜索项目和详细信息
GitlabCreateMRCommentTool ：向合并请求添加注释
GitlabAcceptMRTool ：接受并合并合并请求
GitlabUpdateMRTool ：更新合并请求受让人、审阅者、标题、描述和标签
GitlabCreateMRTool ：与受让人和审阅者创建新的合并请求
GitlabRawApiTool ：使用自定义参数调用任何 GitLab API
Related MCP server: gitlab-mcp-server
快速入门
# Install dependencies
bun install
# Build the project
bun run build
# Start the server
bun run start
环境变量
GITLAB_API_URL=https://your-gitlab-instance.com
GITLAB_TOKEN=your_access_token
# Optional: Provide a mapping from usernames to user IDs (JSON string)
# This can reduce API calls, especially when referencing the same users frequently
# Example: '{"username1": 123, "username2": 456}'
GITLAB_USER_MAPPING={"username1": 123, "username2": 456}
# Optional: Provide a mapping from project names to project IDs (JSON string)
# Project IDs can be numbers or strings (e.g., 'group/project')
# This can reduce API calls and ensure the correct project is used
# Example: '{"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 server entry point
├── 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 config
USAGE.md # Usage examples
package.json
tsconfig.json
一体化
Claude 桌面客户端
添加到您的配置：
{
"mcpServers": {
"@zephyr-mcp/gitlab": {
"command": "npx",
"args": ["-y", "@zephyr-mcp/gitlab"]
}
}
}
锻造工艺
直接在 Smithery 平台上使用：
smithery add @zephyr-mcp/gitlab
或者在 Smithery UI 中搜索“@zephyr-mcp/gitlab”并添加到您的工作区。
环境变量：
GITLAB_API_URL：GitLab API 的基本 URLGITLAB_TOKEN：GitLab API 身份验证的访问令牌