Recall: Appwrite Functions 上のメモリ MCP サーバー

Recall は Appwrite 上に構築された小さな個人メモリアプリです。Appwrite Function としてホストされるリモート MCP サーバーを同梱しており、Claude Code などの AI ツールがユーザーの許可を得てメモリを保存・検索できます。

メモリは Appwrite VectorsDB データベースに保存されます。各メモリは bge-small モデルで埋め込みされ、コサイン類似度クエリで意味に基づいて取得されます。認証はプロジェクトの OAuth2 サーバーで実行されます。AI クライアントが自身を登録し、ユーザーは 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. コンソールで、ID recall の VectorsDB データベースを作成し、bge-small (384) 埋め込みモデルを使用して ID memories のコレクションを作成し、embeddings フィールドに hnsw_cosine インデックスを追加します。

3. スコープ sessions.write、users.read、apps.read、databases.read、collections.read、collections.write、documents.read、documents.write、embeddings.write を持つ API キーを作成します。

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 を実行し、Authenticate を選択します。Recall ユーザーとしてサインインし、アクセスを承認して、Claude に何かを覚えてもらうよう依頼します。