Recall: ein MCP-Server für Erinnerungen auf Appwrite Functions

Recall ist eine kleine App für persönliche Erinnerungen, die auf Appwrite basiert. Sie bringt einen Remote-MCP-Server mit, der als Appwrite Function gehostet wird, sodass KI-Tools wie Claude Code mit Zustimmung des Nutzers Erinnerungen speichern und durchsuchen können.

Erinnerungen werden in einer Appwrite-VectorsDB-Datenbank gespeichert: Jede Erinnerung wird mit dem Modell bge-small eingebettet und über eine Cosine-Similarity-Abfrage nach Bedeutung abgerufen. Die Authentifizierung läuft über den OAuth2-Server des Projekts: KI-Clients registrieren sich selbst, Nutzer genehmigen den Zugriff auf einem Zustimmungsbildschirm, den Recall bereitstellt, und der MCP-Server verifiziert die Tokens, die das Projekt ausstellt. Es werden keine API-Schlüssel ausgegeben, und Nutzer können ein Tool jederzeit trennen.

Begleit-Repository zum Appwrite-Blog-Tutorial „Build a memory MCP server on Appwrite“.

Aufbau

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

Einrichtung

1. Erstelle ein Appwrite-Projekt.

2. Erstelle in der Console eine VectorsDB-Datenbank mit der ID recall, dann eine Collection mit der ID memories mit dem Embedding-Modell bge-small (384) und füge einen hnsw_cosine-Index auf dem Feld embeddings hinzu.

3. Erstelle einen API-Schlüssel mit den Scopes sessions.write, users.read, apps.read, databases.read, collections.read, collections.write, documents.read, documents.write und embeddings.write.

4. Kopiere .env.example zu .env mit deinem Endpunkt, deiner Projekt-ID, dem API-Schlüssel und einem zufälligen Session-Secret.

5. Öffne in der Console Auth > OAuth2-Server, aktiviere den Server, setze die Autorisierungs-URL auf http://localhost:4200/oauth/consent und füge die Scopes memories.read und memories.write hinzu.

6. Installiere und deploye den MCP-Server (verwendet die Appwrite CLI):

   pnpm install
   appwrite login
   pnpm deploy:mcp

7. Starte die Web-App:

   pnpm dev

8. Verbinde dich von Claude Code aus und verwende die Domain der Funktion aus der Deploy-Ausgabe:

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

   Führe /mcp in Claude Code aus und wähle Authentifizieren. Melde dich als Recall-Nutzer an, genehmige den Zugriff und bitte Claude, sich etwas zu merken.