mcp/neo4j-memory

Neo4j Memory MCP Server 镜像文档

镜像概述与主要用途

Neo4j Memory MCP Server 镜像通过 Neo4j 图数据库集成提供持久化内存能力，支持知识图谱中实体、关系和观测数据的创建、查询、更新与删除操作。该镜像实现了 Model Context Protocol (MCP) 规范，可作为外部系统（如 AI 应用）的持久化记忆存储服务。

核心特性

可用工具

该服务器提供以下 9 种工具，用于知识图谱的管理与查询：

工具详情

add_observations

功能：为现有实体添加新的观测数据。

注意：此工具与外部实体交互。

create_entities

功能：在知识图谱中创建多个新实体。

注意：此工具与外部实体交互。

create_relations

功能：创建实体间的多个新关系。

注意：此工具与外部实体交互。

delete_entities

功能：删除多个实体及其关联的所有关系。

注意：

• 此工具可能执行破坏性更新。
• 此工具具有幂等性：使用相同参数重复调用无额外效果。
• 此工具与外部实体交互。

delete_observations

功能：从实体中删除特定观测数据。

注意：

• 此工具可能执行破坏性更新。
• 此工具具有幂等性：使用相同参数重复调用无额外效果。
• 此工具与外部实体交互。

delete_relations

功能：从图谱中删除多个关系。

注意：

• 此工具可能执行破坏性更新。
• 此工具具有幂等性：使用相同参数重复调用无额外效果。
• 此工具与外部实体交互。

find_memories_by_name

功能：按名称查找特定记忆数据。

注意：

• 此工具为只读操作，不修改环境。
• 此工具与外部实体交互。

read_graph

功能：读取整个知识图谱的完整数据。

注意：此工具为只读操作，不修改环境。

search_memories

功能：基于包含搜索词的查询条件搜索记忆数据。

注意：

• 此工具为只读操作，不修改环境。
• 此工具与外部实体交互。

使用场景与适用范围

该镜像适用于以下场景：

• AI 助手的持久化记忆管理（如存储用户偏好、历史交互记录）
• 知识图谱构建与维护（实体、关系的创建、更新与查询）
• 结构化数据的持久化存储与高效检索（支持按名称、条件搜索）
• 需要管理实体观测数据的领域（如科研数据、供应链关系等）

部署与使用方法

环境变量配置

运行镜像前需配置以下环境变量，用于连接 Neo4j 数据库及配置 MCP 服务器：

Docker Run 命令示例

bash
docker run -i --rm \
  -e NEO4J_URL="bolt://neo4j-server:7687" \
  -e NEO4J_USERNAME="neo4j" \
  -e NEO4J_PASSWORD="secure_password" \
  -e NEO4J_DATABASE="memory_db" \
  -e NEO4J_TRANSPORT="http" \
  -e NEO4J_MCP_SERVER_HOST="0.0.0.0" \
  -e NEO4J_MCP_SERVER_PORT="8000" \
  -e NEO4J_MCP_SERVER_PATH="/mcp/" \
  -p 8000:8000 \
  mcp/neo4j-memory

Docker Compose 配置示例

创建 docker-compose.yml 文件：

yaml
version: '3.8'

services:
  neo4j-memory-mcp:
    image: mcp/neo4j-memory
    container_name: neo4j-memory-mcp
    restart: unless-stopped
    ports:
      - "8000:8000"
    environment:
      - NEO4J_URL=bolt://neo4j:7687
      - NEO4J_USERNAME=neo4j
      - NEO4J_PASSWORD=secure_password
      - NEO4J_DATABASE=memory_db
      - NEO4J_TRANSPORT=http
      - NEO4J_MCP_SERVER_HOST=0.0.0.0
      - NEO4J_MCP_SERVER_PORT=8000
      - NEO4J_MCP_SERVER_PATH=/mcp/
    depends_on:
      - neo4j

  neo4j:
    image: neo4j:5.15
    container_name: neo4j-server
    restart: unless-stopped
    ports:
      - "7474:7474"  # HTTP 管理界面
      - "7687:7687"  # Bolt 协议端口
    environment:
      - NEO4J_AUTH=neo4j/secure_password
      - NEO4J_dbms_default__database=memory_db
    volumes:
      - neo4j-data:/data

volumes:
  neo4j-data:

启动服务：

bash
docker-compose up -d

验证部署

部署成功后，可通过以下方式验证 MCP 服务器是否正常运行：

1. 访问 http://<server-host>:<port><path>（如 http://localhost:8000/mcp/）
2. 检查返回的 MCP 服务器元数据及可用工具列表