io.github.dubuqingfeng/gitlab-mcp-server

GitLab MCP (Model Context Protocol) server for AI agents

Open source Open in the app JSON README (API)

About

GitLab MCP (Model Context Protocol) server for AI agents

Details

Kind: MCP servers
Topic: AI, RAG & memory
Publisher: dubuqingfeng
Origin: official
Category: ferramentas
Transport: local
Version: 1.0.1
Stars: 9
Forks: 5
Last push: 2025-09-10T01:24:05Z
Repository state: parado
Language: TypeScript
License: MIT
Added: 2026-08-29 03:02:43
Updated: 2026-08-29 03:02:43
Origin id: io.github.dubuqingfeng/gitlab-mcp-server

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 文档](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 文档](docs/codereview.md)
- [项目特定规则配置指南](docs/project-specific-rules.md)

io.github.dubuqingfeng/gitlab-mcp-server

About

Details

README

More