Mnemo

🚀 Mnemo

Mnemo（ギリシャ語: 記憶）は、Geminiの100万トークンのコンテキストウィンドウとコンテキストキャッシュ機能を活用することで、ClaudeなどのAIアシスタントに大規模なコードベース、ドキュメントサイト、PDFなどにアクセスさせることができます。

🚀 クイックスタート

Mnemoは、Geminiコンテキストキャッシュを介してAIアシスタントのメモリを拡張します。Geminiの100万トークンのコンテキストウィンドウとコンテキストキャッシュ機能を利用して、ClaudeなどのAIアシスタントに大規模なコードベース、ドキュメントサイト、PDFなどにアクセスさせることができます。

✨ 主な機能

なぜMnemoを選ぶのか？

埋め込みと検索を伴う複雑なRAGパイプラインの代わりに、Mnemoはよりシンプルなアプローチを採用しています。

• コードベース全体をGeminiのコンテキストキャッシュにロードする
• 自然言語でクエリを実行する
• Geminiがコンテキストを保持しながらClaudeに処理を任せる

これにより、以下のようなメリットが得られます。

• 完全な記憶 - チャンキングや検索がないため、コンテキストが失われることがありません。
• 低レイテンシ - キャッシュされたコンテキストは迅速に提供されます。
• コスト削減 - キャッシュされたトークンは通常の入力トークンよりも75 - 90%安価です。
• シンプルさ - ベクトルデータベース、埋め込み、複雑な検索ロジックが不要です。

Mnemoは何をロードできるか？

📦 インストール

Mnemoは、ニーズに応じて3つの方法でデプロイできます。

オプション1: ローカルサーバー（開発用および全機能）

開発やローカルファイルをロードする必要がある場合に最適です。

# クローンしてインストール
git clone https://github.com/logos-flux/mnemo
cd mnemo
bun install

# Gemini APIキーを設定
export GEMINI_API_KEY=your_key_here

# サーバーを起動
bun run dev

Claude Code MCP設定:

{
  "mcpServers": {
    "mnemo": {
      "type": "http",
      "url": "http://localhost:8080/mcp"
    }
  }
}

オプション2: セルフホストのCloudflareワーカー（Claude.ai向け推奨）

独自のCloudflareアカウントにデプロイします。データとコストをコントロールできます。

前提条件:

• Cloudflareアカウント（無料プランで可）
• Gemini APIキー

# クローンしてインストール
git clone https://github.com/logos-flux/mnemo
cd mnemo/packages/cf-worker

# シークレットを設定
bunx wrangler secret put GEMINI_API_KEY
bunx wrangler secret put MNEMO_AUTH_TOKEN  # オプションだが推奨

# D1データベースを作成
bunx wrangler d1 create mnemo-cache

# デプロイ
bunx wrangler deploy

Claude.ai MCP設定:

{
  "mcpServers": {
    "mnemo": {
      "type": "http",
      "url": "https://mnemo.<your-subdomain>.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_AUTH_TOKEN"
      }
    }
  }
}

なぜこれを使うのか？ Claude.aiはローカルホストに接続できません。ワーカーはClaude.aiがアクセスできる外部エンドポイントを提供します。

オプション3: 管理型ホスティング（VIP）

インフラストラクチャの管理をしたくない場合、一部のクライアント向けに完全管理型のMnemoホスティングを提供しています。

含まれるもの:

• 専用のワーカーデプロイ
• 優先サポート
• カスタムドメイン
• 使用状況監視

お問い合わせ: 価格と可用性については、lf@logosflux.ioまで。

💻 使用例

基本的な使用法

# GitHubリポジトリをロード
curl -X POST http://localhost:8080/tools/context_load \
  -H "Content-Type: application/json" \
  -d '{"source": "https://github.com/honojs/hono", "alias": "hono"}'

# ドキュメントサイトをロード（トークンターゲットまでクロール）
curl -X POST http://localhost:8080/tools/context_load \
  -H "Content-Type: application/json" \
  -d '{"source": "https://hono.dev/docs", "alias": "hono-docs"}'

# PDFをロード
curl -X POST http://localhost:8080/tools/context_load \
  -H "Content-Type: application/json" \
  -d '{"source": "https://arxiv.org/pdf/2303.08774.pdf", "alias": "gpt4-paper"}'

# 非公開リポジトリをロード（GitHubトークン付き）
curl -X POST http://localhost:8080/tools/context_load \
  -H "Content-Type: application/json" \
  -d '{"source": "https://github.com/owner/private-repo", "alias": "private", "githubToken": "ghp_xxx"}'

# 複数のソースを1つのキャッシュにロード
curl -X POST http://localhost:8080/tools/context_load \
  -H "Content-Type: application/json" \
  -d '{"sources": ["https://github.com/owner/repo", "https://docs.example.com"], "alias": "combined"}'

# キャッシュをクエリ
curl -X POST http://localhost:8080/tools/context_query \
  -H "Content-Type: application/json" \
  -d '{"alias": "hono", "query": "How do I add middleware?"}'

# アクティブなキャッシュをリスト表示
curl -X POST http://localhost:8080/tools/context_list \
  -H "Content-Type: application/json" -d '{}'

# コスト追跡付きの使用状況統計を取得
curl -X POST http://localhost:8080/tools/context_stats \
  -H "Content-Type: application/json" -d '{}'

# 終了後にキャッシュを削除
curl -X POST http://localhost:8080/tools/context_evict \
  -H "Content-Type: application/json" \
  -d '{"alias": "hono"}'

高度な使用法

# サーバーを起動
mnemo serve

# MCP stdioトランスポートを起動（Claudeデスクトップ用）
mnemo stdio

# プロジェクトをロード
mnemo load ./my-project my-proj

# クエリを実行
mnemo query my-proj "What's the main entry point?"

# キャッシュをリスト表示
mnemo list

# キャッシュを削除
mnemo evict my-proj

📚 ドキュメント

MCPツール

context_loadパラメータ

設定

認証

MNEMO_AUTH_TOKENが設定されている場合、/mcpおよび/tools/*エンドポイントは認証が必要です。

# 認証トークンを設定（ワーカー）
bunx wrangler secret put MNEMO_AUTH_TOKEN

# リクエストにはヘッダーを含める必要があります:
Authorization: Bearer your-token-here

公開エンドポイント（認証不要）:

• GET /health - ヘルスチェック
• GET / - サービス情報
• GET /tools - 利用可能なツールのリスト

コスト

どのデプロイオプションを選択しても、常にGemini APIの使用料を支払う必要があります。MnemoはGeminiのコンテキストキャッシュを使用しており、標準入力よりも大幅に安価です。

例: 10万トークンのコードベースを1時間キャッシュし、10回のクエリを実行すると、約$0.47になります。

Cloudflareのコスト（セルフホスト）:

• ワーカー: 無料プランで1日10万リクエストまで
• D1: 無料プランで1日500万回の読み取りまで
• 適度な使用ではおそらく$0になります。

🔧 技術詳細

┌─────────────────────────────────────────────────────────────┐
│                         Mnemo                                │
├─────────────────────────────────────────────────────────────┤
│  MCP Tools                                                   │
│  • context_load    - Load into Gemini cache                 │
│  • context_query   - Query cached context                   │
│  • context_list    - Show active caches                     │
│  • context_evict   - Remove cache                           │
│  • context_stats   - Token usage, costs                     │
│  • context_refresh - Reload cache                           │
├─────────────────────────────────────────────────────────────┤
│  Adapters (v0.2)                                             │
│  • GitHub repos (via API)                                   │
│  • URL loading (HTML, PDF, JSON, text)                      │
│  • Token-targeted crawling                                  │
│  • robots.txt compliance                                    │
├─────────────────────────────────────────────────────────────┤
│  Packages                                                    │
│  • @mnemo/core      - Gemini client, loaders, adapters      │
│  • @mnemo/mcp-server - MCP protocol handling                │
│  • @mnemo/cf-worker - Cloudflare Workers deployment         │
│  • @mnemo/local     - Bun-based local server                │
└─────────────────────────────────────────────────────────────┘

📄 ライセンス

MIT

クレジット

Logos Flux | Voltage Labsによって開発されました。