🚀 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"}
使用示例
详细示例请参见 USAGE.md。
项目结构
src/
├── server/
│ └── GitlabMCPServer.ts # MCP 服务器入口文件
├── tools/
│ ├── GitlabAcceptMRTool.ts
│ ├── GitlabCreateMRCommentTool.ts
│ ├── GitlabGetUserTasksTool.ts
│ ├── GitlabRawApiTool.ts
│ ├── GitlabCreateMRTool.ts
│ └── GitlabUpdateMRTool.ts
└── README.md # 项目文档