Hippocampal Memory MCP

🧠 海马存储器MCP服务器

使用Neo4j和语义搜索进行神经解剖学启发的记忆巩固的MCP服务器。

特性

• 情景记忆编码：创建具有情感价值和时间背景的记忆事件
• 语义检索：使用OpenAI嵌入进行向量相似性搜索
• 图的运算：完全支持Cypher查询读写
• 关系跟踪：监测粘结强度随时间的变化
• 可扩展架构：中的其他工具 海马张力 准备集成

快速开始

看 检查表.md 获取每日启动说明。

1.安装依赖项

npm install

2.安装Neo4j

您需要Neo4j Desktop在本地运行，并在端口7687上运行数据库。

3.初始化架构

npm run setup-schema

4.设置隧道（用于远程访问）

启动ngrok以公开您本地的Neo4j：

ngrok tcp 7687

复制隧道URL（例如。， tcp://2.tcp.us-cal-1.ngrok.io:12841)

5.配置克劳德桌面

编辑 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "hippocampal-memory": {
      "command": "node",
      "args": ["C:\\Users\\harve\\Neo4j\\hippocampal-mcp-server.mjs"],
      "env": {
        "NEO4J_URI": "bolt://YOUR_NGROK_URL",
        "NEO4J_USER": "neo4j",
        "NEO4J_PASSWORD": "your_password",
        "OPENAI_API_KEY": "your_openai_key"
      }
    }
  }
}

6.启动克劳德桌面

MCP服务器将自动连接。

可用工具（8）

海马模块（仿生模式）

1. hippocampus_write_event -使用Who/Why/What/Where/Effects块创建结构化事件
2. hippocampus_write_reflection -具有自我中心视角的代理相对内存切片
3. hippocampus_search_events -使用时间/参与者/效果过滤器进行模式完成检索

核心内存工具

1. encode_memory -使用向量嵌入保存情景记忆
2. recall_memory -语义+时间+情感搜索
3. query_graph -只读Cypher查询
4. mutate_graph -写入操作（CREATE、MERGE等）
5. evolve_bond -随着时间的推移跟踪关系动态

建筑

当前设置：

• Neo4j桌面在端口7687上本地运行
• 用于远程访问的ngrok隧道
• Claude Desktop通过stdio传输连接
• 在以下位置渲染部署https://hippocampal-memory-mcp.onrender.com（HTTP/SSE传输）

文件夹：

• hippocampal-mcp-server.mjs -主服务器（克劳德桌面的stdio）
• 远程mcp-server.mjs -HTTP/SSE服务器（用于远程连接）
• 海马张力 -其他仿生工具
• setup-vector-index.mjs -架构初始化
• 测试连接.mjs -本地连接测试
• test-tunnel.mjs -隧道连接试验

模式

核心节点：

• 事件-具有向量嵌入的情景记忆
• 人-人类和人工智能实体
• 项目-正在进行的工作
• 概念-抽象概念
• 地点、催化剂、实体、目标、效果、反射、代理（扩展模式）

关键关系：

• 参与-活动→ 实体（具有角色和显著性）
• 前置-活动→ 事件（因果链）
• 合并活动→ 概念/人员/项目
• 债券-个人↔ 人（有力量轨迹）
• 参与者\_ IN、催化剂\_ BY、HELD_AT、HAD_EFFECT_ON等。（扩展架构）

指标：

• 事件嵌入向量索引（1536维，余弦相似性）
• 人员、项目、概念、事件的id字段的唯一约束

重要说明

• ngrok URL更改 每次重启时（除非您为静态URL付费）
• 当ngrok URL更改时，更新Claude Desktop配置中的NEO4J_URI
• 启动Claude Desktop之前，必须先运行Neo4j Desktop
• 环境变量位于Claude Desktop配置中（非.env文件）
• 渲染部署需要持久的Neo4j（Aura）-本地隧道无法工作

测试

测试本地连接：

node test-connection.mjs

试验隧道连接：

node test-tunnel.mjs

文档

• 检查表.md -日常启动和工具添加指南
• neo4j-agent说明.md -全面的Neo4j/Cypher/GraphQL指南
• docs/ -存档的安装指南和部署说明

部署

当前部署到Render的位置：https://hippocampal-memory-mcp.onrender.com

有关部署的详细信息，请参阅存档文档。