内容
# GitLab MCP 服务器(Python 实现)
Model Context Protocol(MCP)服务器,用于与 GitLab 集成,基于 FastMCP 构建。
该服务器使用 Python 实现,基于 fastmcp。
## 快速开始
1. 构建 Docker 镜像:
```bash
docker build -t gitlab-mcp-server .
```
## 与 Cursor/Claude 集成
在 MCP 设置 -> 添加 MCP 服务器,添加以下配置:
```json
{
"mcpServers": {
"gitlab": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e",
"GITLAB_TOKEN",
"-e",
"GITLAB_URL",
"gitlab-mcp-server:latest"
],
"env": {
"GITLAB_TOKEN": "token",
"GITLAB_URL": "https://gitlab.com/"
}
}
}
}
```
注意:请记得替换 `GITLAB_TOKEN` 和 `GITLAB_URL` 的值为您实际的 GitLab 凭证和实例 URL。
## 获取 GitLab Token
1. 登录您的 GitLab 账户
2. 进入 设置 -> 访问令牌
3. 创建新的令牌:
- 作用域:选择必要的权限:
- `api` - 用于 API 访问
- `read_repository` - 用于读取仓库
- `write_repository` - 用于写入仓库
4. 点击 "创建个人访问令牌"
5. 复制生成的令牌(它只会显示一次!)
## 提示(规则)用于审查
以下是一些建议,以改进和澄清您的 review.mdc 规则,用于代码审查:
---
**review.mdc(改进版)**
**目的:**
当前分支中进行代码审查的指南,重点关注与 origin/master 分支的差异,并与 MCP GitLab 服务器集成。
---
### 1. 审查范围
- 只审查当前分支相对于 origin/master 分支的更改。
- 使用 MCP 工具在 GitLab 中找到此分支对应的合并请求(MR)。
---
### 2. 审查结构
- **更改摘要:**
- 提供一个简洁的摘要,分为两个部分:
- **业务更改:** 描述对业务逻辑、用户体验或需求的影响。
- **代码更改:** 总结技术修改、重构或架构变化。
- **逻辑分解:**
- 将更改分为逻辑块(例如,功能、错误修复、重构)。
- 清晰地列出这些块。
- **详细审查:**
- 对于每个块,提供:
- 简要描述。
- 改进建议(代码质量、可读性、维护性、性能等)。
- 潜在错误或问题的识别。
- 用表情符号说明建议类型。
- 链接到代码行。
- 如果没有提供参考条件(需求/规格),请请求它们以确保准确的审查。
---
### 3. 建议和评论
- 建议在合并请求中使用 MCP GitLab 服务器直接发布行注释。
- 合并请求中的所有行注释必须:
- 以 "[AI]" 开头。
- 具体、可行并引用相关代码行。
- 不要写太多文字。越小越好。
---
### 4. 其他指南
- 在所有反馈中优先考虑清晰、简洁和建设性。
- 关注业务逻辑和代码质量。
- 确保所有建议都有理由,并尽可能引用最佳实践或项目标准。
- 如果您发现一个错误,请解释推理和潜在影响。
## 贡献
欢迎:
- 添加新的 GitLab 集成工具和功能
- 改进现有功能
- 修复错误
- 增强文档
- 建议改进
要贡献:
1. 分叉仓库
2. 创建功能分支
3. 提交更改
4. 打开拉取请求
所有贡献,无论大小,都受到赞赏!