Weasley DeepMind

Weasley DeepMind

Weasley DeepMind は、AI エージェント向けのセルフホスト可能なメモリーサーバーです。小さく型付けされたメモリーフラグメントを保存し、関連するエビデンスをリンクして、会話履歴全体を毎回プロンプトに含めることなく、MCP を通じて適切なコンテキストを呼び出します。

Weasley Open Source ファミリーの一員であり、Apache-2.0 ライセンスで公開されています。

DeepMind を選ぶ理由

• 会話履歴のダンプではなく、役立つ情報を呼び出します。 キーワード検索、PostgreSQL GIN 検索、グラフ近傍検索、オプションの pgvector 検索を統合し、トークン予算内で順位付けします。
• 構造化されたメモリー。 事実、決定事項、手順、好み、エピソード、エラーには、出所、重要度、リンク、ライフサイクルの状態が保持されます。
• MCP ネイティブ。 ローカルの stdio プロセス、または /mcp の Streamable HTTP エンドポイントを使用できます。
• フェイルクローズ方式の HTTP セキュリティ。 アクセスキーが設定されていない場合、HTTP サーバーはリクエストを拒否します。認証を無効にできるのは、ローカル開発用に明示的に設定した場合のみです。
• セルフホスト可能なデータ。 PostgreSQL が信頼できる唯一のデータソースです。Redis と外部の埋め込みモデルまたは LLM プロバイダーはオプションです。
• 運用にすぐ使えます。 PostgreSQL のアドバイザリロックでマイグレーションを直列化し、ログからシークレットを秘匿します。また、変更のある Git チェックアウトでは更新を拒否します。

要件

• Node.js 20.19 以降
• pgvector 拡張機能を備えた PostgreSQL 15 以降
• Redis 7（オプション。キャッシュと低レイテンシのキーワード検索用）

npm からインストールする

npm install --global weasley-deepmind

pgvector を使って PostgreSQL データベースを作成し、接続を設定します。

export DATABASE_URL='postgresql://postgres:password@localhost:5432/weasley_deepmind'
export WEASLEY_DEEPMIND_ACCESS_KEY='replace-with-a-long-random-secret'

weasley-deepmind migrate
weasley-deepmind serve

HTTP サーバーはデフォルトで http://127.0.0.1:57332 をリッスンします。MCP エンドポイントは http://127.0.0.1:57332/mcp です。

MCP クライアントに追加する

npm パッケージには、改行区切りの stdio トランスポートが含まれています。一般的な MCP クライアント設定は次のようになります。

{
  "mcpServers": {
    "weasley-deepmind": {
      "command": "npx",
      "args": ["-y", "weasley-deepmind", "stdio"],
      "env": {
        "DATABASE_URL": "postgresql://postgres:password@localhost:5432/weasley_deepmind",
        "WEASLEY_DEEPMIND_AUTO_MIGRATE": "true"
      }
    }
  }
}

すでに実行中の HTTP 環境では、クライアントの接続先を /mcp に設定し、Authorization: Bearer <WEASLEY_DEEPMIND_ACCESS_KEY> を送信します。

リポジトリをローカルで実行する

git clone https://github.com/potatohoney-p/weasley-deepmind.git
cd weasley-deepmind
npm ci
docker compose -f docker-compose.dev.yml up -d
cp .env.example.minimal .env
npm run migrate
npm start

開発用 Compose ファイルは、PostgreSQL を localhost:35432、Redis を localhost:36379 で公開します。サーバーを起動する前に、.env をこれらのポートに合わせて更新してください。

基本的なフロー

flowchart LR
    Agent["AI agent"] --> MCP["stdio or Streamable HTTP"]
    MCP --> Tools["remember · recall · reflect · context"]
    Tools --> Rank["keyword + graph + vector ranking"]
    Rank --> Postgres["PostgreSQL + pgvector"]
    Rank -. optional cache .-> Redis["Redis"]

主なツールセットには、remember、batch_remember、recall、forget、amend、link、reflect、context、memory_stats、memory_consolidate、graph_explore、fragment_history、reconstruct_history、search_traces が含まれます。API キーの権限と動作モードによって、利用できるツールを制限できます。

設定

変数	用途	デフォルト
DATABASE_URL	PostgreSQL 接続 URL	POSTGRES_* から導出
WEASLEY_DEEPMIND_ACCESS_KEY	HTTP モードで必須のベアラーシークレット	なし。HTTP はフェイルクローズ方式
WEASLEY_DEEPMIND_AUTH_DISABLED	明示的に認証を無効化（ループバックのみ）。ループバック以外のリスナーでは起動を拒否	false
WEASLEY_DEEPMIND_AUTO_MIGRATE	stdio 起動前にマイグレーションを実行	false（server.json では true を推奨）
WEASLEY_DEEPMIND_HOME	CLI キャッシュとローカル状態のディレクトリ	~/.weasley/deepmind
WEASLEY_DEEPMIND_HOST	HTTP リッスンアドレス	127.0.0.1
PORT	HTTP ポート	57332
REDIS_ENABLED	Redis を利用する機能を有効化	false
EMBEDDING_PROVIDER	openai、gemini、ollama、localai、cloudflare、transformers（オプションのインストール）、または custom	openai
EMBEDDING_API_KEY	オプションの埋め込みプロバイダー用シークレット	なし

設定の一覧については、.env.example、設定、インストールガイドを参照してください。

ローカルのトランスフォーマー埋め込みは、オプションのネイティブ画像依存関係がコア MCP サーバーに追加されないよう、デフォルトのインストールから意図的に除外しています。EMBEDDING_PROVIDER=transformers を選択する前に、docs/embedding-local.md の固定された手順に従ってください。

CLI

weasley-deepmind serve       Start the HTTP MCP server
weasley-deepmind stdio       Start the local stdio MCP server
weasley-deepmind migrate     Apply pending database migrations
weasley-deepmind health      Check database, Redis, and embeddings
weasley-deepmind recall      Search memory from the terminal
weasley-deepmind remember    Store a memory fragment
weasley-deepmind update      Preview or apply an update

weasley-deepmind --help を実行するか、すべてのコマンドについては CLI リファレンスを参照してください。

セキュリティのデフォルト設定

• 信頼できるリバースプロキシと明示的なオリジン許可リストがある場合を除き、HTTP リスナーはループバックに設定してください。
• 一意でエントロピーの高い WEASLEY_DEEPMIND_ACCESS_KEY を使用し、.env は決してコミットしないでください。
• Stdio モードではローカルの MCP ホストプロセスを信頼します。ホストアカウントとデータベースの認証情報を適切に保護してください。
• 脆弱性は SECURITY.md の手順に従って非公開で報告してください。

開発

npm ci
npm test
npm run lint
npm run lint:migrations
npm pack --dry-run

アーキテクチャと運用の詳細は、docs/architecture.en.md と docs/operations をご覧ください。CONTRIBUTING.md からの貢献を歓迎します。

ライセンス

Copyright 2026 Weasley Open Source.

Apache License 2.0 に基づいてライセンスされています。著作権表示については NOTICE をご覧ください。