项目简介

RewindDB MCP 服务器是一个基于 Model Context Protocol (MCP) 标准构建的应用后端，它使大型语言模型 (LLM) 能够安全、规范地访问您的 Rewind.ai 个人记忆数据。Rewind.ai 会实时捕获音频转录和屏幕 OCR 数据。通过 RewindDB MCP 服务器，LLM 客户端可以查询历史对话、屏幕内容、应用程序使用情况，并调用相关工具进行数据分析和摘要，从而提供更智能、更具上下文感知的交互。

主要功能点

音频转录检索：获取指定时间段内的音频对话内容，支持相对时间（如“1小时前”）和绝对时间范围，可用于会议纪要、对话摘要等。
屏幕 OCR 数据访问：检索屏幕上出现过的文本内容，了解特定时间段内您在屏幕上看到的信息，支持按应用过滤。
活动统计分析：提供计算机使用模式、应用使用时长、日历会议等综合活动数据，帮助分析工作效率和时间分配。
智能搜索：在音频转录和屏幕 OCR 数据中搜索关键词或短语，快速定位信息。
灵活的时间查询：支持相对时间（如“1天”、“5小时”）和精确的绝对时间范围查询，并处理时区转换。
标准化协议通信：通过 JSON-RPC 协议与 MCP 客户端通信，确保与各类 AI 助手的兼容性（如 Claude、Raycast）。

安装步骤

克隆仓库：

git clone https://github.com/pedramamini/RewindMCP.git
cd RewindMCP

安装依赖：
```
pip install .
```

配置数据库连接：在项目根目录或用户主目录 ('~') 下创建 '.env' 文件，命名为 '.env' 或 '~/.rewinddb.env'。在文件中添加 Rewind.ai 数据库的路径和密码：

DB_PATH=/Users/username/Library/Application Support/com.memoryvault.MemoryVault/db-enc.sqlite3
DB_PASSWORD=your_database_password_here

请根据您的实际 Rewind.ai 数据库位置和密码进行替换。

服务器配置 (MCP 客户端用)

MCP 客户端需要通过 JSON 配置来启动并连接 RewindDB MCP 服务器。以下是一个示例配置，您需要根据实际安装路径调整 'command' 字段中的路径：

{
  "mcpServers": {
    "rewinddb": {
      "command": "python",
      "args": [
        "/path/to/RewindMCP/mcp_stdio.py",
        // 可选参数：
        // "--env-file", "/path/to/your/.env" // 指定包含数据库配置的 .env 文件路径。如果已在默认位置配置，此项可选。
        // "--debug"                          // 启用调试日志
        // "--log", "/tmp/mcp_stdio.log"      // 指定日志文件路径，默认为 /tmp/mcp_stdio.log
      ],
      "env": {
        // 可选：如果不想在 .env 文件中配置，也可以直接在此处设置环境变量
        // "DB_PATH": "/path/to/your/rewind.db",
        // "DB_PASSWORD": "your_password"
      }
    }
  }
}

参数注释：

'rewinddb'：服务器的唯一名称，可自定义。
'command'：启动 Python 解释器的命令，通常是 'python' 或 'python3'。
'args'：传递给 'mcp_stdio.py' 脚本的参数列表。
- 第一个参数是 'mcp_stdio.py' 脚本的完整路径。
- '--env-file /path/to/your/.env'：指定包含数据库配置的 '.env' 文件路径。如果您已在默认位置配置 '.env' 文件，此项可选。
- '--debug'：启用详细的调试日志输出。
- '--log FILE'：将日志输出到指定文件，默认为 '/tmp/mcp_stdio.log'。
'env'：可选，用于设置服务器进程的环境变量，例如直接传递数据库路径和密码。如果在此处设置，则会覆盖 '.env' 文件中的同名变量。

基本使用方法

一旦配置好 MCP 客户端并连接到 RewindDB MCP 服务器，您就可以通过 LLM 客户端与服务器进行交互。例如，您可以向 LLM 提出以下问题，LLM 将调用 RewindDB MCP 服务器提供的工具来获取信息：

“总结我昨天下午3点到4点的会议内容。” （调用 'get_transcripts_absolute' 工具）
“过去两小时我的屏幕上都显示了什么？” （调用 'get_screen_ocr_relative' 工具）
“查找我最近提到‘项目截止日期’的所有对话。” （调用 'search_transcripts' 工具）
“告诉我过去一天我的电脑使用了哪些应用程序，以及使用时长。” （调用 'get_activity_stats' 工具）
“过去一周内，我在Chrome浏览器上看到过哪些包含‘AI’字样的内容？” （调用 'search_screen_ocr' 工具）

关键词

项目简介

主要功能点

安装步骤

服务器配置 (MCP 客户端用)

基本使用方法

信息