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凭证和实例URL替换GITLAB_TOKEN和GITLAB_URL值。

获取GitLab令牌

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. 打开拉取请求

无论大小，我们都非常感谢所有的贡献！