English Version
mcp-gitlab MCP 服务器 (英文)
基于 fastmcp 框架构建的 GitLab 集成服务器,提供丰富的 GitLab RESTful API 工具。支持与 Claude、Smithery 等平台集成。
特征
- GitlabSearchUserProjectsTool :按用户名搜索用户及其活跃项目
- GitlabGetUserTasksTool :获取当前用户的待处理任务
- GitlabSearchProjectDetailsTool :搜索项目和详细信息
- GitlabCreateMRCommentTool :向合并请求添加注释
- GitlabAcceptMRTool :接受并合并合并请求
- GitlabUpdateMRTool :更新合并请求受让人、审阅者、标题、描述和标签
- GitlabCreateMRTool :与受让人和审阅者创建新的合并请求
- GitlabRawApiTool :使用自定义参数调用任何 GitLab API
快速入门
# 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 身份验证的访问令牌
相关链接