
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
描述:通过自然语言与Neon数据库交互。
该镜像由Acuvity打包,并发布至其精选MCP服务器 registry,源来自@neondatabase/mcp-server-neon的原始代码库。
快速链接:
📦 隔离的不可变沙箱
| 特性 | 描述 |
|---|---|
| 隔离执行 | 所有工具在安全的容器化沙箱中运行,强制进程隔离,防止横向移动 |
| 默认非root | 遵循最小权限原则,减少潜在安全漏洞的影响 |
| 只读文件系统 | 确保运行时不可变性,防止未授权修改 |
| 版本固定 | 通过锁定工具和依赖版本,保证部署的一致性和可复现性 |
| CVE扫描 | 使用Docker Scout持续扫描镜像中的已知漏洞,支持主动 mitigation |
| SBOM与溯源 | 嵌入元数据和可追溯的构建信息,提供完整的供应链透明度 |
| 容器签名(Cosign) | 使用Cosign实现镜像签名,确保容器镜像的完整性和真实性 |
🛡️ 运行时安全与护栏
Minibridge集成:Minibridge建立安全的Agent-to-MCP连接,支持Rego/HTTP-based政策执行,并简化编排。
容器内置Rego政策,提供一系列运行时护栏以强化安全、隐私和服务正确使用:
| 护栏 | 摘要 |
|---|---|
resource integrity | 嵌入所有暴露资源的哈希,确保真实性,防止未授权修改 |
covert-instruction-detection | 检测请求中的隐藏或混淆指令 |
sensitive-pattern-detection | 标记敏感数据或文件系统暴露的模式 |
shadowing-pattern-detection | 识别覆盖或影响其他工具的描述 |
schema-misuse-prevention | 强制输入数据严格遵守 schema |
cross-origin-tool-access | 控制对外部服务或API的调用 |
secrets-redaction | 防止凭证或敏感值暴露 |
basic authentication | 配置共享密钥以限制未授权访问 |
[!NOTE] 默认情况下,除
resource integrity外所有护栏均关闭,可单独启用/禁用所需保护。
NEON_API_KEY:必填,需设置该环境变量以连接Neon数据库。Visual Studio Code
全局配置:
按下ctrl + shift + p,选择Preferences: Open User Settings JSON,添加以下内容:
json{ "mcp": { "servers": { "acuvity-mcp-server-neon": { "env": { "NEON_API_KEY": "TO_BE_SET" }, "command": "docker", "args": ["run", "-i", "--rm", "--read-only", "-e", "NEON_API_KEY", "docker.io/acuvity/mcp-server-neon:0.6.5"] } } } }
工作区配置:
在工作区创建.vscode/mcp.json文件:
json{ "servers": { "acuvity-mcp-server-neon": { "env": { "NEON_API_KEY": "TO_BE_SET" }, "command": "docker", "args": ["run", "-i", "--rm", "--read-only", "-e", "NEON_API_KEY", "docker.io/acuvity/mcp-server-neon:0.6.5"] } } }
OpenAI Python SDK
本地运行:
pythonasync with MCPServerStdio( params={ "env": {"NEON_API_KEY":"TO_BE_SET"}, "command": "docker", "args": ["run","-i","--rm","--read-only","-e","NEON_API_KEY","docker.io/acuvity/mcp-server-neon:0.6.5"] } ) as server: tools = await server.list_tools()
本地HTTP/sse运行
consoledocker run -it -p 8000:8000 --rm --read-only -e NEON_API_KEY docker.io/acuvity/mcp-server-neon:0.6.5
客户端配置:
json{ "mcpServers": { "acuvity-mcp-server-neon": { "url": "http://localhost:8000/sse" } } }
安装命令:
consolehelm install mcp-server-neon oci://docker.io/acuvity/mcp-server-neon --version 1.0.0
需提前设置NEON_API_KEY作为Secret。集群内可通过服务mcp-server-neon:8000访问。
使用Cosign验证镜像完整性:
consolecosign verify --certificate-oidc-issuer "https://token.actions.githubusercontent.com" --certificate-identity "https://github.com/acuvity/mcp-servers-registry/.github/workflows/release.yaml@refs/heads/main" docker.io/acuvity/mcp-server-neon:latest
维护者:
获取帮助:
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

来自真实用户的反馈,见证轩辕镜像的优质服务