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가 아닌 자신의 계정에 유지됩니다.
작동 방식(간소화된 흐름)
- 배포 – 원클릭 Cloudflare Workers 배포(또는 이를 대신해 주는 제공 데스크톱 앱 사용). 생성 리소스: D1 DB(SQL 스토리지), Vectorize 인덱스, KV 캐시, Workers AI 모델.
- 캡처 – 모든 클라이언트가
{content, source, tags, …}와 함께/capture엔드포인트(또는 MCPremember)를 호출합니다. 워커는 텍스트를 저장하고, 임베딩 모델을 실행하고, 항목을 분류하고, 중복을 확인하고, 벡터 인덱스에 추가합니다. - 구성 – 백그라운드 야간 작업이 전체 텍스트 관련성 인덱스를 만들고, 관련 메모리를 연결하고, 주간 인사이트를 생성합니다.
- 회상 – 클라이언트가 자연어 쿼리(
recall)를 보냅니다. 워커는 벡터 유사도 검색을 수행하고, 전체 텍스트 인덱스로 재순위를 매기고, 관계를 따라가며 가장 관련성 높은 메모리(소스 링크 포함)를 반환합니다. - 프롬프트 캡슐 – 특별히 태그된 메모리(
capsule:*)는 결정적이고 크기가 제한된 텍스트 블록으로 컴파일되어 캐시되고 LLM 프롬프트의 안정적인 접두사로 사용할 수 있습니다.
시작하기(빠른 단계)
- 데스크톱 앱 – Releases 페이지에서 다운로드하고 실행한 후 암호를 설정하고 Cloudflare에 로그인합니다. 앱이 워커를 프로비저닝하고 AI 도구를 자동으로 연결합니다.
- 또는 수동 배포 –
npm install && npm run vectors:create && npm run deploy(Wrangler, Cloudflare 계정, D1/Vectorize 플랜 필요). - 클라이언트 연결 – 제공된 MCP URL(
https://<your-worker>.workers.dev/mcp)을AUTH_TOKEN(Bearer 헤더)과 함께 사용합니다. README에는 Claude, ChatGPT, Cursor, VS Code, Obsidian, Notion 등에 대한 기성 통합이 나열되어 있습니다. - 시도 –
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 계정 아래에 유지됩니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트