# gitlab-mcp-server [Health: Active]

**Category:** 🔄 Version Control  
**Repository:** https://github.com/dubuqingfeng/gitlab-mcp-server  
**GitHub Stars:** 9  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/gitlab-mcp-server

## Description
GitLab MCP (Model Context Protocol) server for AI agents

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "gitlab-mcp-server": {
    "url": "https://gitlab.com"
  }
}
```

## Documentation & README

Gitlab Mcp server

支持服务：

1. gitlab
6. code-review-rules (代码审查规则)

# 场景

1. gitlab 代码 review，获取信息
4. 智能代码审查规则 - 根据项目类型提供代码审查建议


# GitLab

GitLab 集成使用 `@gitbeaker/rest` 库支持获取 Merge Request 信息。

## 环境变量
```bash
export GITLAB_TOKEN="your_personal_access_token"
export GITLAB_URL="https://gitlab.com"  # 可选，默认为 gitlab.com（注意：不需要 /api/v4 后缀）
```

## 可用工具
- `get_merge_request`: 获取特定 MR 的详细信息
- `list_merge_requests`: 列出项目的 MR 列表
- `gitlab_code_review`: 对 MR 进行综合代码审查
- `gitlab_branch_code_review`: 对指定分支进行全面代码审查
- `gitlab_commit_review`: 对指定提交进行代码审查
- `get_file_content`: 获取仓库中特定文件的内容
- `list_branches`: 列出项目的所有分支
- `write_gitlab_mr_note`: 在 MR 中写入审查备注（支持灵活的通知模式）

## 依赖
- `@gitbeaker/rest`: GitLab API 客户端库

详细使用说明请参考 [GitLab 文档](https://github.com/dubuqingfeng/gitlab-mcp-server/blob/HEAD/docs/gitlab.md)

# Lark 机器人集成

支持通过 Lark（飞书）机器人发送通知，可以在写入 GitLab MR 评论时自动发送 Lark 通知。

## 环境变量
```bash
export LARK_WEBHOOK_URL="https://open.feishu.cn/open-apis/bot/v2/hook/xxx"  # Lark 机器人 Webhook URL
export LARK_SECRET_KEY="your_secret_key"  # 可选：签名密钥（如果机器人启用了签名验证）
export LARK_ENABLE_NOTIFICATION="true"  # 可选：是否启用通知，默认为 true
export GITLAB_NOTE_MODE="gitlab_only"  # 可选：通知模式 - gitlab_only(仅GitLab)、lark_only(仅Lark)、both(两者都发)，默认为 gitlab_only
```

## 功能特性
- 灵活的通知模式：可以选择只写 GitLab、只发 Lark 或两者都做
- 支持富文本卡片消息，包含项目名称、MR 标题、评论内容等信息
- 支持自定义 Lark 消息（文本或卡片格式）
- 失败不影响主流程，确保 GitLab 操作的可靠性

## 通知模式说明
- **gitlab_only**: 仅写入 GitLab MR 评论，不发送 Lark 通知（默认）
- **lark_only**: 仅发送 Lark 通知，不写入 GitLab MR 评论
- **both**: 同时写入 GitLab MR 评论并发送 Lark 通知

## 使用示例
```javascript
// 使用环境变量配置的默认模式
await write_gitlab_mr_note({
  projectId: "group/project",
  mergeRequestIid: 123,
  note: "代码审查完成，LGTM！"
});

// 明确指定只写入 GitLab
await write_gitlab_mr_note({
  projectId: "group/project",
  mergeRequestIid: 123,
  note: "内部备注",
  notificationMode: "gitlab_only"
});

// 只发送 Lark 通知，不写入 GitLab
await write_gitlab_mr_note({
  projectId: "group/project",
  mergeRequestIid: 123,
  note: "团队通知：代码已审查",
  notificationMode: "lark_only"
});

// 强制两者都执行（覆盖环境变量）
await write_gitlab_mr_note({
  projectId: "group/project",
  mergeRequestIid: 123,
  note: "重要通知",
  notificationMode: "both"
});

```

# Code Review Rules (代码审查规则)

智能代码审查规则系统，根据不同项目类型和文件扩展名提供相应的代码审查建议。

## 可用工具
- `get_code_review_rules`: 获取适用于特定项目和文件的代码审查规则
- `list_all_code_review_rules`: 列出所有可用的代码审查规则  
- `get_project_types`: 获取支持的项目类型信息

## 支持的项目类型
- TypeScript / JavaScript
- React
- Node.js
- Go
- Python  
- Rust
- Backend (通用后端规则)
- Database (数据库相关)

## 规则类别
- 🔒 Security (安全)
- ⚡ Performance (性能)
- 🔧 Maintainability (可维护性)
- 🎨 Style (代码风格)
- ✨ Best Practice (最佳实践)

## 项目特定规则
支持为特定项目配置专属的代码审查规则：
- 可以通过外部 JSON 配置文件定义项目特定规则
- 支持启用/禁用默认规则
- 支持排除特定的默认规则
- 可以添加额外的项目类型

详细使用说明请参考：
- [Code Review 文档](https://github.com/dubuqingfeng/gitlab-mcp-server/blob/HEAD/docs/codereview.md)
- [项目特定规则配置指南](https://github.com/dubuqingfeng/gitlab-mcp-server/blob/HEAD/docs/project-specific-rules.md)