acuvity/mcp-server-neo4j-cypher

mcp-server-neo4j-cypher 镜像说明

镜像概述

该镜像由Acuvity打包发布，基于https://github.com/neo4j-contrib/mcp-neo4j/tree/HEAD/servers/mcp-neo4j-cypher%E6%9E%84%E5%BB%BA%EF%BC%8C%E7%94%A8%E4%BA%8E%E5%9C%A8%E5%A4%A7%E8%AF%AD%E8%A8%80%E6%A8%A1%E5%9E%8B%EF%BC%88LLMs%EF%BC%89%E4%B8%8ENeo4j%E5%9B%BE%E6%95%B0%E6%8D%AE%E5%BA%93%E4%B9%8B%E9%97%B4%E7%AE%A1%E7%90%86Cypher%E6%9F%A5%E8%AF%A2%EF%BC%8C%E6%94%AF%E6%8C%81%E8%87%AA%E7%84%B6%E8%AF%AD%E8%A8%80%E5%88%B0Cypher%E8%AF%AD%E5%8F%A5%E7%9A%84%E8%BD%AC%E6%8D%A2%E4%B8%8E%E6%89%A7%E8%A1%8C%EF%BC%8C%E4%BF%9D%E9%9A%9C%E5%AE%89%E5%85%A8%E5%8F%AF%E9%9D%A0%E7%9A%84%E4%BA%A4%E4%BA%92%E4%BD%93%E9%AA%8C%E3%80%82

核心功能

1. 自然语言交互：支持LLM通过自然语言生成并执行Neo4j的Cypher查询。
2. 安全隔离沙箱：默认非root用户运行，采用只读文件系统，实现进程隔离，降低安全风险。
3. 运行时防护：内置Rego策略，提供敏感数据检测、schema合规检查、密钥脱敏等防护措施（默认仅启用资源完整性校验，可按需配置）。
4. 多架构支持：兼容amd64和arm64架构，适配不同部署环境。
5. 供应链透明：提供SBOM（软件物料清单）和来源追踪，支持Cosign镜像签名验证。

使用场景

• 开发者利用LLM快速生成Neo4j图数据库的Cypher查询语句，提升开发效率。
• 企业将知识图谱查询功能集成到AI应用中，简化用户通过自然语言访问数据的流程。
• 需要安全、可靠的LLM与Neo4j交互中间层的场景。

配置说明

环境变量（必填）

• NEO4J_DATABASE：目标Neo4j数据库名称
• NEO4J_PASSWORD：Neo4j访问密码
• NEO4J_URI：Neo4j服务地址（如bolt://neo4j:7687）
• NEO4J_USERNAME：Neo4j用户名

Docker部署示例

本地HTTP/SSE模式

bash
docker run -it -p 8000:8000 --rm --read-only \
  -e NEO4J_DATABASE=your_db \
  -e NEO4J_PASSWORD=your_pwd \
  -e NEO4J_URI=bolt://localhost:7687 \
  -e NEO4J_USERNAME=neo4j \
  docker.io/acuvity/mcp-server-neo4j-cypher:0.5.2

部署后可通过http://localhost:8000/sse访问服务。

VS Code集成

在用户设置JSON中添加配置：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-neo4j-cypher": {
        "env": {
          "NEO4J_DATABASE": "TO_BE_SET",
          "NEO4J_PASSWORD": "TO_BE_SET",
          "NEO4J_URI": "TO_BE_SET",
          "NEO4J_USERNAME": "TO_BE_SET"
        },
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--read-only",
          "-e",
          "NEO4J_DATABASE",
          "-e",
          "NEO4J_PASSWORD",
          "-e",
          "NEO4J_URI",
          "-e",
          "NEO4J_USERNAME",
          "docker.io/acuvity/mcp-server-neo4j-cypher:0.5.2"
        ]
      }
    }
  }
}

Kubernetes部署（Helm）

安装Helm Chart：

bash
helm install mcp-server-neo4j-cypher oci://docker.io/acuvity/mcp-server-neo4j-cypher --version 1.0.0 \
  --set env.NEO4J_DATABASE=your_db \
  --set env.NEO4J_URI=bolt://neo4j-service:7687 \
  --set env.NEO4J_USERNAME=neo4j \
  --set secrets.NEO4J_PASSWORD.value=your_pwd

服务默认通过集群内mcp-server-neo4j-cypher服务的8000端口访问。 ===FULL_DESC===