AI Cloud Memory Community Edition

AI 클라이언트를 위한 나만의 공유 메모리, 프로젝트 보드, 장기 로드맵. Cloudflare 계정에서 실행되며 GitHub 신원을 통해 소유권이 인증됩니다.

AI Cloud Memory는 Codex, Claude Code, OpenCode 및 호환되는 웹 클라이언트에 지속적인 메모리와 프로젝트 수명주기 작업을 위한 하나의 인증된 MCP 엔드포인트를 제공합니다. D1이 표준 저장소입니다. 검색은 기본적으로 어휘(lexical) 및 시간(temporal) 모드로 작동하며, Vectorize와 Workers AI는 나중에 의미론적 검색(semantic retrieval)과 재순위화(reranking)를 위해 활성화할 수 있습니다.

n8n, 자체 서버, 벤더 계정 또는 이 프로젝트가 운영하는 서비스가 필요하지 않습니다. 각 도입자는 자신의 Cloudflare 및 GitHub 계정에 격리된 복사본을 배포합니다.

제공 기능

• 소유자 전용 GitHub OAuth 및 범위가 제한된 MCP OAuth

• 출처(provenance), 라벨, 아카이브, 대체(supersession), 검토 기능을 갖춘 메모리 및 상시 지시사항

• 프로젝트, Kanban 작업, 완료 영수증, 아카이브된 작업 및 완료(Done) 기록

• 작업으로 안전하게 승격할 수 있는 장기 프로젝트 로드맵

• 시간 쿼리 처리, 제한된 순위 부스트 및 의미론적 중복 제거

• 설명 가능한 검색 결과 및 비공개 관련성 벤치마크

• 관리형 Obsidian Markdown 프로젝션 및 휴대용 암호화 내보내기

• 데스크톱 및 모바일 Safari용으로 설계된 반응형 대시보드

• 24개의 세밀하게 범위가 지정된 cloudmemory_* MCP 도구

• 자동화 플랫폼을 의존성으로 만들지 않는 선택적 커넥터 및 자동화 자격 증명

아키텍처

Codex · Claude · OpenCode · compatible web clients
                         │
                 OAuth-protected MCP
                         │
             Cloudflare Worker + dashboard
                ┌────────┼────────┐
                │        │        │
               D1       KV    Static assets
           canonical   OAuth      UI
                │
       optional derived services
       Vectorize · Workers AI
                │
       optional encrypted export
             your GitHub repo

Worker, 데이터베이스, OAuth 상태 및 선택적 AI 인덱스는 도입자의 소유입니다. 공개 프로젝트에는 중앙 메모리 서비스가 없으며 배포된 인스턴스에 접근할 수 없습니다. 아키텍처 및 개인정보 보호를 참조하세요.

배포

1. 나만의 복사본 만들기

위의 Deploy to Cloudflare 버튼을 사용하세요. Cloudflare가 GitHub 복사본을 만들고 wrangler.jsonc에서 지원되는 Worker 바인딩을 프로비저닝할 수 있습니다.

계정에서 자동 Vectorize 프로비저닝을 사용할 수 없는 경우, 의미론적 검색을 활성화하기 전에 선택적 인덱스를 먼저 생성하세요:

npx wrangler vectorize create ai-cloud-memory --dimensions=768 --metric=cosine

해당 인덱스가 생성될 때까지 SEMANTIC_SEARCH_ENABLED=false를 유지하세요. 이 모드에서 기본 제품은 Workers AI 또는 Vectorize를 호출하지 않습니다.

2. 최종 URL 선택

생성된 workers.dev 오리진을 사용하거나 최종 커스텀 도메인을 연결하세요. 후행 슬래시 없이 정확한 HTTPS 오리진을 기록하세요. 예:

https://ai-cloud-memory.your-subdomain.workers.dev

PUBLIC_ORIGIN을 해당 오리진으로 설정하세요. auto는 초기 배포 중에만 유용합니다. GitHub OAuth를 만들기 전에 최종 오리진을 설정하면 두 번째 OAuth 콜백 마이그레이션이 필요 없습니다.

3. GitHub OAuth 앱 만들기

GitHub에서 Settings → Developer settings → OAuth Apps → New OAuth App을 엽니다.

클라이언트 ID를 기록하고 클라이언트 시크릿을 생성하세요. 시크릿을 커밋하지 마세요.

4. 소유자 잠금 구성

wrangler.jsonc 또는 Cloudflare 대시보드에서 다음 비시크릿 Worker 변수를 설정하세요:

ALLOWED_GITHUB_USER_ID=your numeric GitHub user ID
ALLOWED_GITHUB_LOGIN=your GitHub login
PUBLIC_ORIGIN=https://your-final-origin.example
SEMANTIC_SEARCH_ENABLED=false

숫자 사용자 ID는 변경 불가능한 보안 경계이며, 로그인은 표시용 메타데이터입니다. 신뢰할 수 있는 터미널에서 시크릿을 설정하세요:

npx wrangler secret put GITHUB_CLIENT_ID
npx wrangler secret put GITHUB_CLIENT_SECRET
openssl rand -hex 32 | npx wrangler secret put COOKIE_ENCRYPTION_KEY

5. 마이그레이션 및 배포

npm ci
npm run check
npm run deploy

배포 명령은 새 계정에서 의도적으로 두 번 게시합니다. 첫 번째 패스에서 Cloudflare가 선언된 리소스를 자동 프로비저닝하고, 마이그레이션이 D1을 초기화하며, 최종 패스가 검증된 애플리케이션 릴리스가 됩니다. 플레이스홀더 소유자 잠금은 교체할 때까지 부트스트랩 배포에 접근할 수 없게 유지합니다.

그런 다음 배포된 오리진에서 /setup.html을 열어 로컬 브라우저 전용 체크리스트를 확인하세요. 전체 지침은 배포 및 온보딩에 있습니다.

AI 클라이언트 연결

원격 MCP 엔드포인트:

https://your-final-origin.example/mcp

일반적인 네이티브 클라이언트:

# Codex
codex mcp add cloud-memory --url https://your-final-origin.example/mcp

# Claude Code
claude mcp add --transport http cloud-memory https://your-final-origin.example/mcp

OpenCode는 opencode.json에서 원격 MCP 항목을 사용할 수 있습니다:

{
  "mcp": {
    "cloud-memory": {
      "type": "remote",
      "url": "https://your-final-origin.example/mcp",
      "enabled": true
    }
  }
}

각 클라이언트에서 OAuth를 별도로 완료하세요. cloudmemory_health, cloudmemory_board, 무해한 검색, 그리고 명시적으로 승인된 쓰기 하나를 검증하세요. 웹 클라이언트 기능 및 플랜 제한은 다를 수 있습니다. 클라이언트 설정을 참조하세요.

필수 및 선택 서비스

Cloudflare의 한도 및 가격은 변경될 수 있습니다. 선택 서비스를 활성화하기 전에 현재 Workers 가격, D1 가격, Vectorize 가격 및 Workers AI 가격을 확인하세요. 이 프로젝트는 사용자를 대신하여 유료 사용량이나 청구를 활성화하지 않습니다.

의미론적 검색

안전한 기본값은 어휘 전용입니다:

SEMANTIC_SEARCH_ENABLED=false

새 메모리는 보류 중인 벡터 상태로 D1에 표준 저장됩니다. 변수를 true로 설정하고 배포한 다음 설정에서 Repair index를 선택하면 Cloud Memory가 제한된 배치로 벡터를 백필합니다. 구성된 BGE 모델은 768차원 코사인 인덱스를 사용합니다. 의미론적 검색을 참조하세요.

백업 및 복구

대시보드는 GitHub 토큰 없이 암호화된 다운로드를 생성할 수 있습니다. 선택적 GitHub 전달에는 다음이 필요합니다:

• EXPORT_ENCRYPTION_KEY — 저장소 외부의 안전한 곳에 보관

• GITHUB_EXPORT_TOKEN — 하나의 백업 저장소에 대한 Contents 액세스 범위의 세분화된 토큰

• GITHUB_EXPORT_REPOSITORY — owner/repository 형식

암호화 키를 분실하면 기존 암호화된 내보내기를 복구할 수 없습니다. D1이 표준 저장소로 유지되며, Obsidian 및 GitHub 출력은 프로젝션 및 복구 산출물이지 동시 쓰기 대상이 아닙니다.

로컬 개발

Node.js 22.12 이상이 필요합니다.

npm ci
npm run dev
npm run check

전체 검사는 저장소 안전성 검증, 배포 템플릿 검증, 린트, 타입 검사, 단위 테스트, Worker/D1 테스트 및 프로덕션 빌드를 실행합니다.

프로젝트 거버넌스

• 보안 정책

• 기여

• 지원

• 행동 강령

• 변경 로그

Codex Cloud 자동 검토는 AI Cloud Memory의 일부가 아닙니다. 유지관리자는 외부 저장소 관리로 이 GitHub 저장소를 Codex Cloud 환경에 연결할 수 있습니다. 제품에는 검토 에이전트, 토큰 또는 기능이 포함되어 있지 않습니다.

라이선스

MIT. Cloudflare, GitHub, Claude, ChatGPT, Codex, OpenCode, Obsidian 및 n8n은 각 소유자의 상표이며 이 프로젝트와 제휴 관계가 없습니다.