acuvity/mcp-server-gitlab

mcp-server-gitlab镜像说明

镜像概述

mcp-server-gitlab是Acuvity打包发布的MCP服务器镜像，用于调用GitLab API，基于安全设计原则构建，确保可靠且安全的运行环境。

核心功能

安全特性

• 隔离沙箱：工具在容器化沙箱运行，实现进程隔离。
• 非root默认：遵循最小权限原则，降低漏洞影响范围。
• 只读文件系统：防止运行时未授权修改，保证环境 immutable。
• 版本固定：锁定工具及依赖版本，确保部署一致性。
• CVE扫描：通过Docker Scout持续检测漏洞，支持主动防护。
• SBOM与溯源：嵌入元数据与构建信息，提升供应链透明度。
• 容器签名：使用Cosign签名，确保镜像完整性与真实性。

运行时防护

• Minibridge集成：提供安全Agent-MCP连接，支持Rego/HTTP策略管控。
• Guardrails机制：包含资源完整性检测、敏感数据识别、密钥脱敏等防护（默认仅启用资源完整性）。

使用场景

1. IDE集成：支持VS Code、Windsurf、Cursor、Claude Desktop等，通过配置文件快速接入。
2. Docker部署：本地STDIO运行、HTTP/sse服务、远程WebSocket隧道（含MTLS）。
3. Kubernetes部署：通过Helm Charts部署，支持集群内访问与监控。

配置说明

环境变量

• 必填：GITLAB_PERSONAL_ACCESS_TOKEN（GitLab个人访问令牌）。
• 可选：GITLAB_API_URL（GitLab API地址，默认未设置）。

Docker部署示例

本地HTTP/sse运行

bash
docker run -it -p 8000:8000 --rm --read-only -e GITLAB_PERSONAL_ACCESS_TOKEN=<你的令牌> docker.io/acuvity/mcp-server-gitlab:2025.4.25

客户端配置示例：

json
{
  "mcpServers": {
    "acuvity-mcp-server-gitlab": {
      "url": "http://localhost:8000/sse"
    }
  }
}

本地STDIO运行

客户端配置参数：

• 命令：docker
• 参数：run -i --rm --read-only -e GITLAB_PERSONAL_ACCESS_TOKEN=<你的令牌> docker.io/acuvity/mcp-server-gitlab:2025.4.25

Kubernetes部署

通过Helm安装：

bash
helm install mcp-server-gitlab oci://docker.io/acuvity/mcp-server-gitlab --version 1.0.0

需提前配置GITLAB_PERSONAL_ACCESS_TOKEN密钥。