rahilp/second-brain-cloudflare

One memory layer, every AI tool. Store anything once — recall it in Claude, ChatGPT, Cursor, or any MCP client. Self-hosted on Cloudflare's free tier.

Second Brain – AI 도구를 위한 개인 및 팀 메모리

개요 – 메모, 결정 사항, 선호도 및 기타 프로젝트 사실을 저장하고 의미로 검색(시맨틱 검색)할 수 있는 클라우드 호스팅 "지식 베이스"입니다. Cloudflare Worker 로 실행되며 Cloudflare D1, Vectorize, Workers AI 및 KV를 백엔드로 사용하고 간단한 REST/MCP API를 통해 MCP 호환 AI 어시스턴트(Claude, ChatGPT, Cursor, Codex 등)와 통신합니다.


중요성

문제 Second Brain의 해결책
AI 어시스턴트는 공유 컨텍스트가 없어 모든 앱에서 동일한 정보를 반복해야 합니다. 모든 클라이언트가 쿼리하는 단일의 개인 및 팀 전체 메모리 레이어를 제공하여 동일한 사실을 어디서나 사용할 수 있습니다.
메모를 검색하려면 정확한 문구를 기억해야 합니다. 시맨틱 임베딩을 통해 의미로 회상 할 수 있습니다. 쿼리 표현이 달라도 동일한 사실을 찾을 수 있습니다.
메모를 여러 곳(Obsidian, Notion, 이메일, 캘린더)에 보관하면 정보가 분산됩니다. 통합 기능을 통해 원본 소스 메타데이터를 보존하면서 이러한 소스에서 직접 동일한 브레인으로 캡처합니다.
팀에는 공유 지식 베이스가 필요하지만 개인 프라이버시도 필요합니다. Team Edition 은 각 사용자에게 개인 작업 공간과 공유 "회사" 레이어를 제공합니다. 공유는 복사가 아닌 단일 표준 메모리를 이동합니다.
시맨틱 검색 확장은 비용이 많이 들 수 있습니다. Cloudflare Vectorize를 사용하여 저렴하고 빠른 벡터 검색을 제공합니다. 사용할 수 없으면 키워드 검색으로 대체되고 인덱스는 야간 작업으로 자동 확장됩니다.

핵심 기능(높은 수준)

  • 시맨틱 캡처 및 회상 – remember, recall, append, update 등은 자연어 쿼리로 작동합니다.
  • 자동 구성 – 분류, 중복 감지, 관계 그래프, 시간 인식 순위, 주간 인사이트.
  • 다중 레이어 액세스 – personal(개인), company(공유 팀), 향후 team 레이어.
  • 프롬프트 캡슐 – LLM 게이트웨이의 프롬프트에 앞에 추가할 수 있는 결정적이고 읽기 전용인 "핵심" 또는 프로젝트별 컨텍스트 블록.
  • 풍부한 통합 – 데스크톱 앱(터미널 불필요), CLI, 브라우저 확장, Obsidian 동기화, Notion 동기화, 캘린더/이메일 훅, iOS 단축어, Claude Code, Codex, Cursor, VS Code Copilot, Gemini CLI용 훅.
  • 제어 및 감사 – 대시보드에서 찾아보기, 편집, 삭제, 내보내기, 기록 보기 가능. 관리자 도구로 구성원 및 공유 권한 관리.
  • Cloudflare 계정에서 자체 호스팅 – 모든 데이터(벡터, 자격 증명, 메모리)는 타사 SaaS가 아닌 자신의 계정에 유지됩니다.

작동 방식(간소화된 흐름)

  1. 배포 – 원클릭 Cloudflare Workers 배포(또는 이를 대신해 주는 제공 데스크톱 앱 사용). 생성 리소스: D1 DB(SQL 스토리지), Vectorize 인덱스, KV 캐시, Workers AI 모델.
  2. 캡처 – 모든 클라이언트가 {content, source, tags, …}와 함께 /capture 엔드포인트(또는 MCP remember)를 호출합니다. 워커는 텍스트를 저장하고, 임베딩 모델을 실행하고, 항목을 분류하고, 중복을 확인하고, 벡터 인덱스에 추가합니다.
  3. 구성 – 백그라운드 야간 작업이 전체 텍스트 관련성 인덱스를 만들고, 관련 메모리를 연결하고, 주간 인사이트를 생성합니다.
  4. 회상 – 클라이언트가 자연어 쿼리(recall)를 보냅니다. 워커는 벡터 유사도 검색을 수행하고, 전체 텍스트 인덱스로 재순위를 매기고, 관계를 따라가며 가장 관련성 높은 메모리(소스 링크 포함)를 반환합니다.
  5. 프롬프트 캡슐 – 특별히 태그된 메모리(capsule:*)는 결정적이고 크기가 제한된 텍스트 블록으로 컴파일되어 캐시되고 LLM 프롬프트의 안정적인 접두사로 사용할 수 있습니다.

시작하기(빠른 단계)

  1. 데스크톱 앱 – Releases 페이지에서 다운로드하고 실행한 후 암호를 설정하고 Cloudflare에 로그인합니다. 앱이 워커를 프로비저닝하고 AI 도구를 자동으로 연결합니다.
  2. 또는 수동 배포 – npm install && npm run vectors:create && npm run deploy(Wrangler, Cloudflare 계정, D1/Vectorize 플랜 필요).
  3. 클라이언트 연결 – 제공된 MCP URL(https://<your-worker>.workers.dev/mcp)을 AUTH_TOKEN(Bearer 헤더)과 함께 사용합니다. README에는 Claude, ChatGPT, Cursor, VS Code, Obsidian, Notion 등에 대한 기성 통합이 나열되어 있습니다.
  4. 시도 – curl -X POST https://<worker>/capture -H "Authorization: Bearer <token>" -d '{"content":"second brain is working","source":"test"}'는 {"ok":true,"id":"..."}를 반환해야 합니다.

누가 사용해야 하나요?

  • Claude, ChatGPT, Copilot 등에서 작동하는 영구적이고 검색 가능한 메모리를 원하는 개인 AI 파워 유저.
  • 개인 메모를 비공개로 유지하면서 공유 "세컨드 브레인"이 필요한 중소 규모 팀.
  • 결정적 컨텍스트 블록(프롬프트 캡슐)이 필요한 사용자 지정 AI 에이전트 또는 게이트웨이를 구축하는 개발자.
  • 데이터를 SaaS 공급자가 아닌 자신의 Cloudflare 계정에 유지하려는 모든 사용자.

제한 사항 및 고려 사항

  • Cloudflare Vectorize에 의존합니다. 서비스가 비활성화되면 시스템은 키워드 검색으로 대체되어 시맨틱 품질이 저하됩니다.
  • 현재 Team Edition은 브레인당 하나의 공유 팀을 지원합니다(다중 팀은 향후 릴리스에서 계획).
  • 프롬프트 캡슐에는 12k자 하드 예산이 있습니다. 초과 항목은 건너뛰거나 409 오류가 발생합니다.
  • 모든 클라이언트 인증은 토큰 기반입니다. 보안을 위해 쿼리 문자열 토큰은 v3에서 제거되었습니다.

TL;DR

Second Brain은 Cloudflare에서 호스팅되는 시맨틱 메모리 저장소로, 사용자와 팀이 모든 AI 어시스턴트에 일관되고 검색 가능한 컨텍스트를 제공할 수 있게 해줍니다. 원클릭으로 배포하고, 수십 가지 일상 도구에서 캡처하고, 정확한 표현이 아닌 의미로 정보를 검색할 수 있습니다. 모든 데이터는 자신의 Cloudflare 계정 아래에 유지됩니다.

관련

  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트
  • 프로젝트