项目简介

Recall 是一个轻量级的自托管应用程序，旨在作为您个人或团队的记忆数据存储库。它允许您以日志（Journal）和条目（Entry）的形式保存信息，并使用标签进行组织和检索。特别之处在于，Recall 通过 Model Context Protocol (MCP) 暴露其功能，使得兼容MCP的AI模型（如Claude、Cursor等）可以直接访问和利用这些存储的记忆作为上下文信息或调用其提供的功能。

主要功能点

• 自托管与轻量化： 部署简单，通常只需一个二进制文件，无需复杂的外部依赖。
• SQLite 后端： 使用可靠的 SQLite 数据库存储数据，管理方便，无需独立数据库服务器。
• 日记（Journals）管理： 创建、列出、获取、更新和删除不同主题的日记本，用于分类存储记忆。
• 条目（Entries）管理： 在日记本中创建、列出、获取、更新、软删除和清理具体条目，每个条目包含标题、内容和内容类型。
• 标签系统： 为条目添加和移除标签，方便通过关键词组织和检索记忆。
• 标签搜索： 支持通过匹配标签来搜索相关条目，并根据匹配标签数量进行排序。
• MCP兼容性： 提供标准的MCP接口，允许兼容的AI客户端发现并调用上述功能。

安装步骤

通常最简单的方式是从项目的 Releases 页面 下载适用于您操作系统的最新预编译二进制文件。下载后，您可以将可执行文件放在您系统的 PATH 环境变量包含的目录中，或直接从其存放位置运行。

服务器配置（供MCP客户端参考）

MCP客户端需要通过启动外部进程来连接MCP服务器。对于 Recall，您需要配置客户端来运行 Recall 的 MCP 模式命令。配置通常包含服务器名称、执行命令及其参数。

• 服务器名称 (name): 您可以为这个连接起一个易于识别的名称，例如 “Recall Memory Server” 或 “我的记忆库”。
• 执行命令 (command): 指向 Recall 可执行文件的路径，例如在 Linux/macOS 上可能是 'recall' (如果已加入 PATH)，或 '/path/to/recall/binary'。
• 参数 (args): 启动 MCP 服务器模式的参数。基本参数是 'mcp'。您也可以指定数据库文件的位置，例如 'mcp --db /path/to/your/recall.db'。
  • 默认数据库路径： 如果不指定 '--db' 参数，Recall 会使用系统默认位置存储数据库文件：
    • Windows: '%USERPROFILE%\AppData\Roaming\recall\recall.db'
    • macOS: '~/Library/Application Support/recall/recall.db'
    • Linux: '~/.local/share/recall/recall.db'
  • 建议： 对于初次使用，可以不指定 '--db' 使用默认路径。如果您需要将数据库放在其他位置，请使用 '--db' 参数指定完整路径。

基本使用方法

要启动 Recall MCP 服务器以便 AI 客户端连接，您只需运行：

recall mcp

如果您想指定数据库文件的位置：

recall mcp --db /path/to/your/database.db

运行此命令后，Recall 会启动并在标准输入/输出 (STDIO) 上通过 JSON-RPC 协议与连接的 MCP 客户端进行通信。此时，您的 AI 客户端应该配置并连接到 Recall。服务器会将其状态日志（如数据库路径、可用工具等）输出到标准错误 (STDERR)，以避免干扰 MCP 协议的 JSON 输出。您可以通过按 'Ctrl+C' 停止服务器。

AI 客户端连接后，就可以调用 Recall 提供的 MCP 工具来创建、管理和搜索您的记忆条目。