项目简介
Klaudium 是一个基于 Model Context Protocol (MCP) 构建的内存服务器,旨在为大型语言模型(LLM)应用提供结构化的知识存储和检索能力。它在原有的 MCP 内存服务器基础上进行了增强,引入了时间感知、重要性跟踪和分类系统等特性,以更有效地管理和利用上下文信息。目前项目正在积极开发中,已实现基本的 MCP 内存服务器功能和增强的实体、关系结构。
主要功能点
- 基础知识图谱功能: 支持实体和关系的创建、读取、更新和删除 (CRUD) 操作,以及基本的搜索能力。
- 增强的记忆管理:
- 时间感知: 为实体和关系添加时间戳,支持基于时间的分析和记忆压缩(未来功能)。
- 记忆重要性跟踪: 为实体评分,帮助确定记忆保留的优先级。
- 分类系统: 支持实体分类,更好地组织记忆。
- 记忆统计: 跟踪实体和关系总数,以及记忆的 token 大小。
- 工具 (Tools) 支持: 通过 MCP 协议提供一系列工具,允许 LLM 客户端操作知识图谱,例如:
- 'create_entities': 创建实体
- 'create_relations': 创建关系
- 'add_observations': 为实体添加观察
- 'delete_entities': 删除实体
- 'delete_observations': 删除观察
- 'delete_relations': 删除关系
- 'read_graph': 读取整个知识图谱
- 'search_nodes': 搜索节点
- 'open_nodes': 打开(读取)指定节点
安装步骤
由于项目仍在开发中,目前尚未提供详细的安装和使用说明。根据仓库信息,可以推测大致步骤如下 (请关注仓库更新以获取更准确的指南):
- 克隆仓库: 将 Klaudium 仓库克隆到本地。
git clone https://github.com/MilosBastaja/mcp-klaudium.git cd mcp-klaudium - 安装依赖: 使用 npm 或 yarn 安装项目依赖。
npm install - 构建项目 (如果需要): 根据 'package.json' 中的 scripts,如果需要构建,则运行构建命令 (例如 'npm run build')。 仓库中 'index.ts' 是 Typescript 代码,可能需要构建成 Javascript 才能直接运行。
服务器配置
Klaudium MCP 服务器通过标准输入/输出 (stdio) 与 MCP 客户端通信。以下是一个 MCP 客户端配置示例,用于连接 Klaudium 服务器。您需要根据实际情况调整 'command' 和 'args' 字段。
{ "serverName": "klaudium-memory-server", "command": "node", "args": [ "/path/to/klaudium-memory-server/dist/index.js" // 请替换为 Klaudium 服务器 index.js 文件在您本地的实际路径 (如果需要构建,则指向构建后的文件) ], "transport": "stdio" }
配置参数说明:
- 'serverName': 服务器名称,可以自定义。
- 'command': 运行服务器的命令,这里使用 'node' (假设您已安装 Node.js 环境)。
- 'args': 传递给 'command' 的参数,这里指定了 Klaudium 服务器入口文件 'index.js' 的路径。请务必将 '/path/to/klaudium-memory-server/dist/index.js' 替换为您本地 Klaudium 项目的实际文件路径。 如果没有构建步骤,并且直接运行 'src/index.ts',则路径应指向 'src/index.ts', 并可能需要使用 'ts-node' 或类似的工具运行 Typescript 代码。
- 'transport': 传输协议,这里设置为 'stdio',表示使用标准输入/输出进行通信。
基本使用方法
- 启动服务器: 在 MCP 客户端中使用上述配置启动 Klaudium MCP 服务器。
- 客户端交互: MCP 客户端将通过 JSON-RPC 协议与 Klaudium 服务器进行通信,发送请求以调用服务器提供的工具,例如创建实体、查询知识图谱等。 具体工具的使用方法请参考 MCP 协议文档和 Klaudium 项目的后续更新。
注意: 由于 Klaudium 项目仍在积极开发中,安装和使用步骤可能会有所变化。请密切关注仓库的 README 文件和更新日志,以获取最新的信息和指南。
信息
分类
数据库与文件