Recall: un servidor MCP de memoria en Appwrite Functions

Recall es una pequeña aplicación de memoria personal construida con Appwrite. Incluye un servidor MCP remoto, alojado como una Function de Appwrite, para que herramientas de IA como Claude Code puedan guardar y buscar los recuerdos de un usuario con su permiso.

Los recuerdos se almacenan en una base de datos VectorsDB de Appwrite: cada recuerdo se incorpora con el modelo bge-small y se recupera por significado mediante una consulta de similitud coseno. La autenticación se realiza en el servidor OAuth2 del proyecto: los clientes de IA se registran, los usuarios aprueban el acceso en una pantalla de consentimiento que aloja el servidor, y el servidor MCP verifica los tokens que emite el proyecto. No se entregan claves de API, y los usuarios pueden desconectar una herramienta en cualquier momento.

Repositorio complementario del tutorial del blog de Appwrite «Build a memory MCP server on Appwrite».

Estructura

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

Configuración

1. Crea un proyecto de Appwrite.

2. En la consola, crea una base de datos VectorsDB con el ID recall, y luego una colección con el ID memories usando el modelo de incrustación bge-small (384), y añade un índice hnsw650 (not)L; ensure it's hnsw_cosine:

3. En la consola, crea una base de datos VectorsDB con el ID recall, luego una colección con el ID memories usando el modelo de incrustación bge-small (384), y añade un índice hnsw_cosine en el campo embeddings.

4. Crea una clave de API con los alcances sessions.write, users.read, apps.read, databases.read, collections.read, collections.write, documents.read, documents.write y embeddings.write.

5. Copia .env.example a .env con tu endpoint, el ID de tu proyecto, la clave de API y una clave secreta de sesión aleatoria.

6. En la consola, abre Autenticación > Servidor OAuth2, habilita el servidor, establece la URL de autorización en http://localhost:4200/oauth/consent y añade los alcances memories.read y memories.write.

7. Instala y despliega el servidor MCP (usa la Appwrite CLI):

   pnpm install
   appwrite login
   pnpm deploy:mcp

8. Ejecuta la aplicación web:

   pnpm dev

9. Conéctate desde Claude Code, usando el dominio de la Function desde el resultado del despliegue:

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

   Ejecuta /mcp dentro de Claude Code y selecciona Authenticate. Inicia sesión como usuario de Recall, aprueba el acceso y pide a Claude que recuerde algo.