Recall: Appwrite Functions에서 실행되는 메모리 MCP 서버

Recall은 Appwrite로 구축된 작은 개인 메모리 앱입니다. Appwrite Function으로 호스팅되는 원격 MCP 서버를 제공하며, 이를 통해 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. 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 서버를 열고 서버를 활성화한 다음, 권한 부여 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

   Claude Code에서 /mcp를 실행하고 인증을 선택합니다. Recall 사용자로 로그인하고 액세스를 승인한 다음 Claude에게 무언가를 기억하도록 요청합니다.