AI Cloud Memory Community Edition

AIクライアント向けの共有メモリ、プロジェクトボード、長期ロードマップを、お使いのCloudflareアカウントで実行し、GitHub IDを通じて所有します。

AI Cloud Memoryは、Codex、Claude Code、OpenCode、および互換性のあるWebクライアントに、永続的なメモリとプロジェクトライフサイクル作業のための単一の認証済みMCPエンドポイントを提供します。D1が正規のデータストアです。検索はデフォルトで語彙モードと時間モードで動作し、VectorizeとWorkers AIは後でセマンティック検索と再ランキングのために有効化できます。

n8n、ホームサーバー、ベンダーアカウント、またはこのプロジェクトが運営するサービスは必要ありません。各採用者は、自分のCloudflareおよびGitHubアカウントに分離されたコピーをデプロイします。

提供される機能

• オーナーのみのGitHub OAuthとスコープ付きMCP OAuth

• 出典、ラベル、アーカイブ、置換、レビューを備えたメモリと常設ディレクティブ

• プロジェクト、カンバンタスク、完了レシート、アーカイブ済み作業、完了履歴

• タスクへの安全な昇格を備えた長期的なプロジェクトロードマップ

• 時間的クエリ処理、境界付きランキングブースト、セマンティック重複排除

• 説明可能な検索結果とプライベートな関連性ベンチマーク

• 管理された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を作成する前に最終オリジンを設定すると、2回目の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

デプロイコマンドは、新しいアカウントでは意図的に2回公開します。最初のパスで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、無害な検索、および明示的に承認された1つの書き込みを確認します。Webクライアントの機能とプラン制限は異なります。クライアント設定を参照してください。

必須およびオプションのサービス

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。1つのバックアップリポジトリのContentsアクセスにスコープされたファイングレイントークン

• GITHUB_EXPORT_REPOSITORY。owner/repository形式

暗号化キーを失うと、既存の暗号化エクスポートは復元できなくなります。D1は正規のままであり、ObsidianとGitHubの出力はプロジェクションとリカバリアーティファクトであり、同時書き込みではありません。

ローカル開発

Node.js 22.12以降が必要です。

npm ci
npm run dev
npm run check

完全なチェックでは、リポジトリの安全性検証、デプロイメントテンプレート検証、lint、型チェック、ユニットテスト、Worker/D1テスト、本番ビルドが実行されます。

プロジェクトガバナンス

• セキュリティポリシー

• 貢献

• サポート

• 行動規範

• 変更履歴

Codex Cloudの自動レビューはAI Cloud Memoryの一部ではありません。メンテナーは、外部リポジトリ管理としてこのGitHubリポジトリをCodex Cloud環境に接続する場合があります。製品にはレビューエージェント、トークン、機能は同梱されていません。

ライセンス

MIT。Cloudflare、GitHub、Claude、ChatGPT、Codex、OpenCode、Obsidian、n8nはそれぞれの所有者の商標であり、このプロジェクトとは提携していません。