Recall: сервер MCP для памяти на Appwrite Functions

Recall — это небольшое приложение для личной памяти, созданное на Appwrite. Оно включает удалённый MCP-сервер, размещённый как Appwrite Function, чтобы ИИ-инструменты вроде Claude Code могли сохранять и искать воспоминания пользователя с его разрешения.

Воспоминания хранятся в базе данных Appwrite VectorsDB: каждое воспоминание векторизуется моделью bge-small и находится по смыслу с помощью запроса на косинусное сходство. Аутентификация работает на OAuth2-сервере проекта: ИИ-клиенты регистрируются, пользователи одобряют доступ на экране согласия, который размещает Recall, а MCP-сервер проверяет токены, выпущенные проектом. Никакие API-ключи не выдаются, и пользователи могут в любой момент отключить инструмент.

Сопутствующий репозиторий для руководства из блога Appwrite «Build a memory MCP server on Appwrite».

Структура

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. В консоли создайте базу данных VectorsDB с ID recall, затем коллекцию с ID memories, используя модель эмбеддингов bge-small (384), и добавьте индекс hnsw_cosine на поле embeddings.

3. Создайте API-ключ с областями sessions.write, users.read, apps.read, databases.read, collections.read, collections.write, documents.read, documents.write и embeddings.write.

4. Скопируйте .env.example в .env, указав ваш endpoint, 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. Запустите веб-приложение:

   pnpm dev

8. Подключитесь из Claude Code, используя домен функции из вывода развёртывания:

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

   Запустите /mcp в Claude Code и выберите Authenticate. Войдите как пользователь Recall, одобрите доступ и попросите Claude что-нибудь запомнить.