acuvity/mcp-server-prisma

mcp-server-prisma镜像说明

镜像概述

mcp-server-prisma是由Acuvity打包的Docker镜像，基于Prisma原始源码构建，旨在让大语言模型（LLM）具备管理Prisma Postgres数据库的能力。镜像强调安全优先，提供隔离沙箱、运行时护栏等特性，支持多种客户端集成与部署方式。

核心功能

🔐 安全隔离沙箱

• 隔离执行：工具在容器化沙箱内运行，防止横向移动
• 非root默认：遵循最小权限原则，降低安全风险
• 只读文件系统：确保运行时不可变，防止未授权修改
• 版本固定：锁定工具及依赖版本，保证部署一致性
• CVE扫描：通过Docker Scout持续扫描漏洞
• 供应链透明：嵌入SBOM与溯源信息

🛡️ 运行时安全护栏

可通过GUARDRAILS环境变量启用以下防护：

• covert-instruction-detection：检测隐藏指令
• sensitive-pattern-detection：拦截敏感数据模式
• shadowing-pattern-detection：防止工具描述劫持
• schema-misuse-prevention：强制Schema合规
• cross-origin-tool-access：控制跨源调用
• secrets-redaction：自动脱敏敏感信息

🔑 基础认证

通过BASIC_AUTH_SECRET环境变量启用共享密钥认证，适用于开发或内部部署场景（需配合TLS使用）。

使用场景

• LLM驱动的数据库Schema管理与更新
• 自动化数据查询、插入与修改操作
• 开发环境中LLM辅助的数据库调试
• 安全可控的LLM数据库操作实验

配置说明

环境变量设置

bash
# 启用敏感信息脱敏与敏感模式检测
docker run -e GUARDRAILS="secrets-redaction sensitive-pattern-detection" ...

# 启用基础认证
docker run -e BASIC_AUTH_SECRET="your-shared-secret" ...

客户端集成

VS Code配置（全局）

在用户设置JSON中添加：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-prisma": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "--read-only", "docker.io/acuvity/mcp-server-prisma:6.9.0"]
      }
    }
  }
}

OpenAI Python SDK集成

python
async with MCPServerStdio(
    params={
        "command": "docker",
        "args": ["run","-i","--rm","--read-only","docker.io/acuvity/mcp-server-prisma:6.9.0"]
    }
) as server:
    tools = await server.list_tools()

Docker部署示例

本地HTTP/sse模式

bash
docker run -it -p 8000:8000 --rm --read-only docker.io/acuvity/mcp-server-prisma:6.9.0

远程Websocket+MTLS模式

bash
# 服务端启动
docker run -e MINIBRIDGE_MODE=backend -v $PWD/certs:/certs \
  -e MINIBRIDGE_TLS_SERVER_CERT=/certs/server-cert.pem \
  -e MINIBRIDGE_TLS_SERVER_KEY=/certs/server-key.pem \
  -e MINIBRIDGE_TLS_SERVER_CLIENT_CA=/certs/client-ca.pem \
  docker.io/acuvity/mcp-server-prisma:6.9.0

Kubernetes部署（Helm）

bash
# 查看Chart信息
helm show readme oci://docker.io/acuvity/mcp-server-prisma --version 1.0.0

# 安装Chart
helm install mcp-server-prisma oci://docker.io/acuvity/mcp-server-prisma --version 1.0.0

更多详细配置请参考https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-prisma%E3%80%82 ===FULL_DESC===