Claw Recall MCP 服务器

使用说明（Markdown 格式）

• 项目简介

  • Claw Recall MCP 服务器是一套实现 MCP 协议的后端服务，旨在为大型语言模型提供结构化的上下文、查询能力和外部工具调用入口。通过 MCP 服务器，LLM 客户端可以读取会话记忆、执行搜索、捕获思想以及浏览最近的活动等。

• 主要功能点

  • 提供多个 MCP 工具（Tools）注册与暴露，例如搜索内存、浏览最近对话、捕获思想、浏览活动、统计内存状态等。
  • 以 MCP 服务器形式提供对外接口，支持本地（stdio）和远程（SSE/HTTP）的传输方式，方便不同部署场景。
  • 与 Claw Recall 的本地数据库、嵌入向量服务以及外部来源（Gmail、Drive、Slack 等）无缝集成，能通过 MCP 调用实现跨源上下文管理与检索。
  • 服务器端负责工具注册、会话管理、能力声明等核心职责，为 LLM 客户端提供可扩展的上下文服务框架。

• 安装步骤（操作简要）

  • 将仓库克隆到本地或服务器
  • 安装依赖（如 Python 环境与 requirements.txt 中的依赖）
  • 启动两种 MCP 传输模式中的任意一种：
    • STDIO 传输模式：python3 -m claw_recall.api.mcp_stdio
    • SSE/HTTP 传输模式：python3 -m claw_recall.api.mcp_sse
  • 配置客户端以连接上述任一服务器（参见 MCP 客户端配置部分）

• 服务器配置（MCP 客户端所需配置格式，示例说明） 说明：MCP 客户端需要在其配置中声明要连接的 MCP 服务器及启动方式。以下 JSON 为示例配置，描述服务器名称、启动命令及参数等信息，便于客户端在本地或云端与服务器建立连接。 { "servers": [ { "name": "claw-recall-stdio", "command": "python3", "args": ["-m", "claw_recall.api.mcp_stdio"], "description": "本地 STDIO 传输的 Claw Recall MCP 服务端", "notes": "适用于同机通信，客户端通过标准输入输出与 MCP 服务交互" }, { "name": "claw-recall-sse", "command": "python3", "args": ["-m", "claw_recall.api.mcp_sse"], "description": "远程 SSE/HTTP 传输的 Claw Recall MCP 服务端", "notes": "适用于跨机器通信，客户端通过 SSE/HTTP 与 MCP 服务交互" } ] }

• 基本使用方法（简单入门）

  • 选择传输模式：若在同一台机器上运行 Agent，推荐使用 STDIO 模式；若在远端运行服务并通过网络访问，选择 SSE/HTTP 模式。
  • 启动服务器后，在 MCP 客户端按照上面的配置将服务器注册为可用服务，并确认能够调用工具（如 memory 搜索、浏览最近对话、捕获思想、查看日志等）。
  • 通过 MCP 客户端调用具体工具：如 search_memory、browse_recent、capture_thought、browse_activity、memory_stats、poll_sources、capture_source_status 等。
  • 如需在本地 Claude/OpenClaw 等工具中接入，请按照对应工具的文档将 claw-recall 的服务器配置加入到工具配置中，使得 Agent 能发现并使用这些工具。

• 备注

  • 本实现集成了与本地数据库和外部服务的调用，确保在本地开发环境或服务器环境中可运行并提供稳定的 MCP 服务。实际使用时请确保 OpenAI keys、数据库路径、网络访问等依赖就绪。