A
security-
licenseA
qualityMCP Server for the GitLab API, enabling project management, file operations, and more.
Last updated -
1,673
72,630
MIT License
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 身份验证的访问令牌
相关链接
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityGitLab MCP Server (with activity tracking and group projects listing features) This server is based on the original GitLab MCP server with Group Projects Listing and Activity Tracking enhancementsLast updated -288629MIT License
- Asecurity-licenseAqualityGitLabとの連携機能を提供するModel Context Protocol (MCP) サーバーです。GitLabの特定のプロジェクトからパイプラインの失敗情報やマージリクエストへの指摘事項を取得し、AIアシスタントに提供します。Last updated -33MIT License
- AsecurityAlicenseAqualityAn MCP server that enables communication with GitLab repositories, allowing interaction with GitLab's API to manage projects, issues, and repositories through natural language.Last updated -4516,1101MIT License