GitLab集成MCP服务器

基于FastMCP的Python实现,用于GitLab集成的模型上下文协议服务器,支持代码审查和合并请求管理。

  • by radostkali
  • Python
  • 本地部署
  • 9 星标
  • 更新于
在 GitHub 查看 radostkali/gitlab-mcp-server

使用说明

GitLab MCP服务器(Python)

用于GitLab集成的模型上下文协议(MCP)服务器,基于FastMCP构建。

此服务器使用Python和fastmcp实现。

快速开始

  1. 构建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代币

  1. 登录您的GitLab帐户
  2. 转到设置->访问令牌
  3. 创建新令牌:
    • 范围:选择必要的权限:
      • api -用于API访问
      • read_repository -用于读取存储库
      • write_repository -用于写入存储库
  4. 点击“创建个人访问令牌”
  5. 复制生成的令牌(它只会显示一次!)

提示(规则)审核

以下是一些改进和澄清代码审查.mdc规则的建议:


review.mdc(改进版)

目的:
在当前分支中进行代码审查的指南,重点是与源/主分支的差异,以及与MCP GitLab服务器的集成。


1.审查范围

  • 仅查看当前分支与源/主分支相比的变化。
  • 使用MCP工具在GitLab中找到此分支的相应合并请求(MR)。

2.审查结构

  • 变更摘要:

    • 提供一份简明的总结,分为两部分:
      • 业务变更: 描述对业务逻辑、用户体验或需求的影响。
      • 代码更改: 总结技术修改、重构或架构转变。
  • 逻辑分解:

    • 将更改划分为逻辑块(例如,功能、错误修复、重构)。
    • 清楚地列出这些块。
  • 详细审查:

    • 对于每个区块,提供:
      • 简要说明。
      • 改进建议(代码质量、可读性、可维护性、性能等)。
      • 识别潜在的错误或问题。
      • 用表情符号说明建议的类型。
      • 链接到代码行。
    • 如果没有提供职权范围(要求/规范),请要求他们确保准确审查。

3.建议和意见

  • 建议使用MCP GitLab服务器直接在合并请求中发布带有建议的行评论。
  • 合并请求中的所有行注释必须:
    • 从“[AI]”开始。
    • 具体、可操作,并参考相关代码行。
    • 不要写太多的文字。越小越好。

4.附加指南

  • 在所有反馈中优先考虑清晰、简洁和建设性。
  • 同时关注业务逻辑和代码质量。
  • 确保所有建议都是合理的,并在可能的情况下参考最佳实践或项目标准。
  • 如果你发现了一个bug,请解释其原因和潜在影响。

贡献

请随意:

  • 添加新的GitLab集成工具和功能
  • 改进现有功能
  • 修复bug
  • 加强文件编制
  • 提出改进建议

贡献:

  1. 分叉存储库
  2. 创建功能分支
  3. 提交您的更改
  4. 打开拉取请求

感谢所有的贡献,无论大小!