Skip to main content
Glama
deenesjakoruzh
Logos-Flux

Mnemo

by Logos-Flux
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid
██╗      ██████╗  ██████╗  ██████╗ ███████╗
██║     ██╔═══██╗██╔════╝ ██╔═══██╗██╔════╝
██║     ██║   ██║██║  ███╗██║   ██║███████╗
██║     ██║   ██║██║   ██║██║   ██║╚════██║
███████╗╚██████╔╝╚██████╔╝╚██████╔╝███████║
╚══════╝ ╚═════╝  ╚═════╝  ╚═════╝ ╚══════╝

        ███████╗██╗     ██╗   ██╗██╗  ██╗
        ██╔════╝██║     ██║   ██║╚██╗██╔╝
        █████╗  ██║     ██║   ██║ ╚███╔╝ 
        ██╔══╝  ██║     ██║   ██║ ██╔██╗ 
        ██║     ███████╗╚██████╔╝██╔╝ ██╗
        ╚═╝     ╚══════╝ ╚═════╝ ╚═╝  ╚═╝

Mnemo

GeminiコンテキストキャッシュによるAIアシスタントのための拡張メモリ。

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

なぜMnemoなのか？

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

  • コードベース全体をGeminiのコンテキストキャッシュに読み込む

  • 自然言語でクエリを実行する

  • Geminiがコンテキストを保持し、Claudeがオーケストレーションを行う

これにより、以下が実現します：

  • 完璧なリコール - チャンク化や検索を行わないため、コンテキストの欠落がありません

  • 低レイテンシ - キャッシュされたコンテキストは高速に提供されます

  • コスト削減 - キャッシュされたトークンは、通常の入力トークンより75〜90%安価です

  • シンプルさ - ベクトルデータベース、埋め込み、複雑な検索ロジックは不要です

Related MCP server: Heimdall MCP Server

Mnemoで読み込めるもの

ソース

ローカルサーバー

Worker

GitHubリポジトリ (公開)

✅

✅

GitHubリポジトリ (非公開)

✅

✅

任意のURL (ドキュメント、記事)

✅

✅

PDFドキュメント

✅

✅

JSON API

✅

✅

ローカルファイル/ディレクトリ

✅

❌

複数ページのクロール

✅ 無制限

✅ 最大40ページ

デプロイオプション

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

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

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

# Clone and install
git clone https://github.com/logos-flux/mnemo
cd mnemo
bun install

# Set your Gemini API key
export GEMINI_API_KEY=your_key_here

# Start the server
bun run dev

Claude Code MCP設定:

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

オプション2: セルフホスト型Cloudflare Worker (Claude.ai向け推奨)

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

前提条件:

# Clone and install
git clone https://github.com/logos-flux/mnemo
cd mnemo/packages/cf-worker

# Configure secrets
bunx wrangler secret put GEMINI_API_KEY
bunx wrangler secret put MNEMO_AUTH_TOKEN  # Optional but recommended

# Create D1 database
bunx wrangler d1 create mnemo-cache

# Deploy
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はlocalhostに接続できません。Workerを使用することで、Claude.aiがアクセス可能な外部エンドポイントを提供します。

オプション3: マネージドホスティング (VIP)

インフラを管理したくない場合、一部のクライアント向けにフルマネージドのMnemoホスティングを提供しています。

内容:

  • 専用Workerデプロイ

  • 優先サポート

  • カスタムドメイン

  • 利用状況モニタリング

連絡先: 価格と空き状況については lf@logosflux.io までお問い合わせください。

使用例

# Load a GitHub repo
curl -X POST http://localhost:8080/tools/context_load \
  -H "Content-Type: application/json" \
  -d '{"source": "https://github.com/honojs/hono", "alias": "hono"}'

# Load a documentation site (crawls up to token target)
curl -X POST http://localhost:8080/tools/context_load \
  -H "Content-Type: application/json" \
  -d '{"source": "https://hono.dev/docs", "alias": "hono-docs"}'

# Load a 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"}'

# Load a private repo (with GitHub token)
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"}'

# Load multiple sources into one cache
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"}'

# Query the cache
curl -X POST http://localhost:8080/tools/context_query \
  -H "Content-Type: application/json" \
  -d '{"alias": "hono", "query": "How do I add middleware?"}'

# List active caches
curl -X POST http://localhost:8080/tools/context_list \
  -H "Content-Type: application/json" -d '{}'

# Get usage stats with cost tracking
curl -X POST http://localhost:8080/tools/context_stats \
  -H "Content-Type: application/json" -d '{}'

# Evict when done
curl -X POST http://localhost:8080/tools/context_evict \
  -H "Content-Type: application/json" \
  -d '{"alias": "hono"}'

CLI

# Start server
mnemo serve

# Start MCP stdio transport (for Claude Desktop)
mnemo stdio

# Load a project
mnemo load ./my-project my-proj

# Query
mnemo query my-proj "What's the main entry point?"

# List caches
mnemo list

# Remove cache
mnemo evict my-proj

MCPツール

ツール

説明

context_load

GitHubリポジトリ、URL、PDF、またはローカルディレクトリをGeminiキャッシュに読み込む

context_query

キャッシュされたコンテキストに対して自然言語でクエリを実行する

context_list

トークン数と有効期限を含むアクティブなキャッシュをすべて一覧表示する

context_evict

キャッシュを削除する

context_stats

コスト追跡を含む利用統計を取得する

context_refresh

最新のコンテンツでキャッシュを再読み込みする

context_load パラメータ

パラメータ

説明

source

単一ソース: GitHub URL、任意のURL、またはローカルパス

sources

1つのキャッシュに結合する複数のソース

alias

このキャッシュのフレンドリーネーム (1〜64文字)

ttl

有効期間 (秒単位) (60〜86400、デフォルト3600)

githubToken

非公開リポジトリ用のGitHubトークン

systemInstruction

クエリ用のカスタムシステムプロンプト

設定

変数

説明

デフォルト

GEMINI_API_KEY

Gemini APIキー

必須

MNEMO_PORT

サーバーポート (ローカルのみ)

8080

MNEMO_DIR

データディレクトリ (ローカルのみ)

~/.mnemo

MNEMO_AUTH_TOKEN

保護されたエンドポイント用の認証トークン

なし

認証

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

# Set auth token (Workers)
bunx wrangler secret put MNEMO_AUTH_TOKEN

# Requests must include header:
Authorization: Bearer your-token-here

パブリックエンドポイント (認証不要):

  • GET /health - ヘルスチェック

  • GET / - サービス情報

  • GET /tools - 利用可能なツールの一覧

コスト

デプロイオプションに関わらず、Gemini APIの利用料金は常に発生します。MnemoはGeminiのコンテキストキャッシュを使用しており、これは標準入力よりも大幅に安価です：

リソース

コスト

キャッシュストレージ

100万トークンあたり約$4.50/時間

キャッシュされた入力

通常入力より75〜90%割引

通常入力

100万トークンあたり約$0.075 (Flash)

例: 10万トークンのコードベースを1時間キャッシュし、10回クエリを実行した場合 ≈ $0.47

Cloudflareコスト (セルフホスト):

  • Workers: 無料枠で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

クレジット

Built by Logos Flux | Voltage Labs

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • CastPlan MCP

    Ghostseller
    A
    license
    B
    quality
    C
    maintenance
    Provides AI assistants with persistent memory of your project architecture, development history, and technical decisions, allowing them to give context-aware coding help without needing repeated explanations.
    16
    61
    2
    MIT

  • Heimdall MCP Server

    lcbcFoo
    A
    license
    Not graded
    quality
    D
    maintenance
    Provides AI coding assistants with persistent, context-rich memory of a codebase, including documentation and git history, enabling recall across sessions.
    104
    Apache 2.0

  • context-mcp

    vibhasdutta
    A
    license
    A
    quality
    B
    maintenance
    Provides persistent memory and a codebase knowledge graph for AI coding assistants, enabling shared context across multiple tools like Claude, Cursor, and ChatGPT, with significant token reduction.
    5
    25
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Logos-Flux/mnemo'

If you have feedback or need assistance with the MCP directory API, please join our Discord server