Recall：Appwrite Functions 上的记忆 MCP 服务器

Recall 是一个基于 Appwrite 构建的小型个人记忆应用。它附带一个远程 MCP 服务器，以 Appwrite Function 的形式托管，因此像 Claude Code 这样的 AI 工具可以在获得用户许可的情况下保存和搜索用户的记忆。

记忆存储在 Appwrite VectorsDB 数据库中：每条记忆都使用 bge-small 模型进行嵌入，并通过余弦相似度查询按语义检索。认证在项目的 OAuth2 服务器上运行：AI 客户端自行注册，用户在 Recall 托管的同意屏幕上批准访问，MCP 服务器验证项目颁发的令牌。不会分发任何 API 密钥，用户可以随时断开某个工具的连接。

Appwrite 博客教程《在 Appwrite 上构建记忆 MCP 服务器》的配套仓库。

目录结构

apps/recall            The Recall web app (TanStack Start): memory dashboard,
                       email sign-in, the OAuth2 consent screen, and a
                       connected apps page.
functions/memory-mcp   The MCP server, deployed as an Appwrite Function.

Related MCP server: Recall

设置

1. 创建一个 Appwrite 项目。

2. 在控制台中，创建一个 ID 为 recall 的 VectorsDB 数据库，然后使用 bge-small（384）嵌入模型创建一个 ID 为 memories 的集合，并在 embeddings 字段上添加 hnsw_cosine 索引。

3. 创建一个 API 密钥，权限范围包括 sessions.write、users.read、apps.read、databases.read、collections.read、collections.write、documents.read、documents.write 和 embeddings.write。

4. 将 .env.example 复制为 .env，填入你的端点、项目 ID、API 密钥以及一个随机会话密钥。

5. 在控制台中，打开 Auth > OAuth2 server，启用服务器，将授权 URL 设置为 http://localhost:4200/oauth/consent，并添加 memories.read 和 memories.write 权限范围。

6. 安装并部署 MCP 服务器（使用 Appwrite CLI）：

   pnpm install
   appwrite login
   pnpm deploy:mcp

7. 运行 Web 应用：

   pnpm dev

8. 使用部署输出中的函数域名，从 Claude Code 连接：

   claude mcp add --transport http recall https://<FUNCTION_DOMAIN>/mcp

   在 Claude Code 中运行 /mcp 并选择 认证。以 Recall 用户身份登录，批准访问，然后让 Claude 记住一些内容。