项目简介

Roampal是一个基于MCP协议的持久记忆系统，通过自动注入相关记忆和评分机制，让AI助手在会话间记住用户信息、偏好和有效解决方案。

主要功能

• 自动上下文注入：在用户发送消息前自动注入相关记忆和评分提示
• 五类记忆集合：
  • 'memory_bank'：用户身份、偏好、目标（永不衰减）
  • 'patterns'：经过验证的有效解决方案（从历史记录自动提升）
• 结果评分学习：通过'score_response'工具记录响应效果，提升有效记忆，降级失败建议
• 文档记忆：支持上传.txt、.md、.pdf文档到'books'集合
• 智能记忆路由：基于知识图谱学习哪些集合最适合哪些查询

安装步骤

1. 安装包：

   pip install roampal
   

2. 初始化配置：

   roampal init
   

   该命令会自动配置Claude Code或Cursor的MCP设置

3. 重启AI工具： 重启Claude Code后，MCP服务器会自动启动

MCP服务器配置

Roampal作为MCP服务器，需要客户端进行配置才能连接。配置信息如下：

{
  "mcpServers": {
    "roampal-core": {
      "command": "python",
      "args": ["-m", "roampal.mcp.server"]

基本使用方法

1. 开始对话：在Claude Code中正常聊天，Roampal会自动：

   • 注入相关记忆和评分提示
   • 自动学习什么方法有效，什么会失败
   • 无需手动"记得..." - 系统自动处理

2. 文档管理：

   # 添加文档到记忆
   roampal ingest document.pdf
   
   # 查看记忆统计
   roampal stats
   
   # 列出所有文档
   roampal books
   
   # 删除文档
   roampal remove "文档标题"
   

核心MCP工具

• 'search_memory'：跨集合搜索记忆
• 'add_to_memory_bank'：存储永久事实
• 'update_memory'：更新现有记忆
• 'delete_memory'：删除过时信息
• 'get_context_insights'：获取用户档案和相关记忆
• 'score_response'：评分前一次交换（由钩子自动调用）
• 'record_response'：存储关键收获