Memory Custom : PouchDB 🧠

Memory Custom : PouchDB 🧠

site icon
2025.04.05 1
JavaScript知识图谱管理数据存储数据库
mcp-memory-pouchdb 是一个基于 MCP 团队提供的 Memory 服务器的扩展项目,主要用于创建和管理通过语言模型(LLM)交互的知识图谱。该项目通过集成 PouchDB 提供了更强大的文档存储功能,支持自定义内存路径和时间戳功能,适用于需要高效管理和存储大量交互数据的场景。
View on GitHub

Overview

基本能力

产品定位

mcp-memory-pouchdb 是一个知识图谱内存服务器,专注于通过语言模型(LLM)交互创建和管理知识图谱,提供高效的数据存储和检索功能。

核心功能

  1. PouchDB 集成:使用 PouchDB 进行文档存储,提供更好的数据一致性、版本控制和性能优化。
  2. 自定义内存路径:支持为不同项目指定不同的内存文件路径,便于数据管理和组织。
  3. 时间戳功能:为每次交互生成时间戳,便于跟踪数据的创建和修改历史。

适用场景

  • 需要高效管理和存储大量交互数据的项目。
  • 需要跟踪和记录交互历史的场景。
  • 需要为不同项目提供独立内存存储的场景。

工具列表

  • Get Current Time:获取当前时间。
  • Set Memory File Path:设置内存文件路径。
  • Create Entities:创建实体。
  • Create Relations:创建关系。
  • Add Observations:添加观察。
  • Delete Entities:删除实体。
  • Delete Observations:删除观察。
  • Delete Relations:删除关系。
  • Read Graph:读取图谱。
  • Search Nodes:搜索节点。
  • Open Nodes:打开节点。

常见问题解答

  • 服务器启动失败:确保 MEMORY_FILE_PATHPOUCHDB_PATH 环境变量已正确设置。
  • 内存访问失败:执行 read_graph 函数重新初始化内存访问。

使用教程

使用依赖

  • Node.js(版本 16 或更高)
  • PouchDB(自动安装为依赖项)

安装教程

  1. 通过 Smithery 安装:

bash npx -y @smithery/cli install @bneil/mcp-memory-pouchdb --client claude

  1. 手动安装:

bash git clone [email protected]:bneil/mcp-memory-pouchdb.git cd mcp-memory-pouchdb npm install

配置

claude_desktop_config.json.cursor/mcp.json 中配置环境变量:

{
  "mcpServers": {
    "memory": {
      "command": "node",
      "args": ["/path/to/mcp-memory-pouchdb/dist/index.js"],
      "env": {
        "MEMORY_FILE_PATH": "/path/to/custom/memory.json",
        "POUCHDB_PATH": "/path/to/custom/pouchdb_directory",
        "DISABLE_MEMORY_FILE": "true"
      }
    }
  }
}

调试方式

  1. 构建并启动服务器:

bash npm run build node dist/index.js

  1. 验证内存访问功能:
  2. 执行 read_graph 函数初始化内存访问。
  3. 检查核心实体是否存在。
  4. 如果内存访问失败,尝试重新执行 read_graph 函数。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。