使用说明
GitLab MCP服务器(Python)
用于GitLab集成的模型上下文协议(MCP)服务器,基于FastMCP构建。
此服务器使用Python和fastmcp实现。
快速开始
- 构建Docker镜像:
docker build -t gitlab-mcp-server .
与Cursor/Claude集成
在MCP设置->添加MCP服务器中,添加以下配置:
{
"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代币
- 登录您的GitLab帐户
- 转到设置->访问令牌
- 创建新令牌:
- 范围:选择必要的权限:
api-用于API访问read_repository-用于读取存储库write_repository-用于写入存储库
- 范围:选择必要的权限:
- 点击“创建个人访问令牌”
- 复制生成的令牌(它只会显示一次!)
提示(规则)审核
以下是一些改进和澄清代码审查.mdc规则的建议:
review.mdc(改进版)
目的:
在当前分支中进行代码审查的指南,重点是与源/主分支的差异,以及与MCP GitLab服务器的集成。
1.审查范围
- 仅查看当前分支与源/主分支相比的变化。
- 使用MCP工具在GitLab中找到此分支的相应合并请求(MR)。
2.审查结构
-
变更摘要:
- 提供一份简明的总结,分为两部分:
- 业务变更: 描述对业务逻辑、用户体验或需求的影响。
- 代码更改: 总结技术修改、重构或架构转变。
- 提供一份简明的总结,分为两部分:
-
逻辑分解:
- 将更改划分为逻辑块(例如,功能、错误修复、重构)。
- 清楚地列出这些块。
-
详细审查:
- 对于每个区块,提供:
- 简要说明。
- 改进建议(代码质量、可读性、可维护性、性能等)。
- 识别潜在的错误或问题。
- 用表情符号说明建议的类型。
- 链接到代码行。
- 如果没有提供职权范围(要求/规范),请要求他们确保准确审查。
- 对于每个区块,提供:
3.建议和意见
- 建议使用MCP GitLab服务器直接在合并请求中发布带有建议的行评论。
- 合并请求中的所有行注释必须:
- 从“[AI]”开始。
- 具体、可操作,并参考相关代码行。
- 不要写太多的文字。越小越好。
4.附加指南
- 在所有反馈中优先考虑清晰、简洁和建设性。
- 同时关注业务逻辑和代码质量。
- 确保所有建议都是合理的,并在可能的情况下参考最佳实践或项目标准。
- 如果你发现了一个bug,请解释其原因和潜在影响。
贡献
请随意:
- 添加新的GitLab集成工具和功能
- 改进现有功能
- 修复bug
- 加强文件编制
- 提出改进建议
贡献:
- 分叉存储库
- 创建功能分支
- 提交您的更改
- 打开拉取请求
感谢所有的贡献,无论大小!
