@sylphlab/tools-memory-mcp

用于知识图谱记忆工具的MCP（模型上下文协议）服务器适配器。

概述

此包提供了一个MCP服务器，该服务器公开了在@sylphlab/tools-memory中定义的知识图谱内存管理工具。它充当适配器，通过stdio上的MCP协议使核心逻辑对AI代理可用。

服务器读取/写入相对路径下的知识图谱数据（默认：memory.jsonl），该路径基于服务器启动时的当前工作目录 (process.cwd())。

特性

• MCP服务器: 作为一个基于stdio的MCP服务器运行。
• 适配器: 使用@sylphlab/tools-adaptor-mcp将核心@sylphlab/tools-memory工具连接到MCP协议。
• 基于CWD的存储: 继承自@sylphlab/tools-memory的基于CWD的存储行为。
• 公开的工具: 提供对createEntities、createRelations、addObservations、deleteEntities、deleteObservations、deleteRelations、readGraph、searchNodes、openNodes等工具的MCP访问。

使用方法

1. 安装:

   # 通常作为主项目的一部分或全局安装
   pnpm add @sylphlab/tools-memory-mcp
   

2. 运行服务器: 该包提供了一个可以直接运行的二进制文件：

   # 直接运行（确保依赖项已构建）
   node ./node_modules/.bin/mcp-memory
   
   # 或者从工作区根目录通过pnpm运行（如果正确链接）
   # pnpm --filter @sylphlab/tools-memory-mcp start
   

   服务器将启动并监听stdio。它将在您运行命令的目录中创建或使用memory.jsonl。

3. 环境变量（可选）: 您可以使用MEMORY_FILE_PATH环境变量指定相对于CWD的不同文件路径或名称（这由底层的@sylphlab/tools-memory包处理）：

   MEMORY_FILE_PATH=./data/my_memory.jsonl node ./node_modules/.bin/mcp-memory
   

开发

• 构建: pnpm build（构建此包及其依赖项）
• 监视: pnpm dev
• 检查/格式化: pnpm format，pnpm check

许可证

MIT