MADB — Agent Memory Database

Name: MADB — Agent Memory Database
Author: spshkar84

ローカル

github.com/spshkar84メモリ・ナレッジ016 週間前に更新

リポジトリ

MADB — Agent Memory Database について

MADBは、ClaudeのセッションやAnthropic APIの開発者向けのローカル優先型メモリデータベースです。MCPツールで意味検索と因果関係を扱い、再利用可能なスキルや複数セッション間の共有にも対応します。

主な機能

01因果関係付きメモリの保存と取得
02複数の指標による意味検索の順位付け
03メモリ間の因果関係の追跡
04再利用可能なスキルの保存と検索
05複数セッションでのストア共有

活用シーン

01Claudeのセッション間でコンテキストを保持
02意味や新しさを基にメモリを検索
03メモリにつながる出来事を追跡
04タスク間で保存済みパターンを再利用

MCP 対応

MCPサーバーは互換クライアントに13種類のメモリツールとメモリリソースを提供します。初回起動時にインストールされるSkillも同梱されています。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "spshkar84-madb-memory": {
      "command": "uvx",
      "args": [
        "madb-mcp-server"
      ],
      "env": {
        "MADB_DATA_DIR": "<MADB_DATA_DIR>",
        "MADB_TENANT_ID": "<MADB_TENANT_ID>",
        "MADB_TELEMETRY": "<MADB_TELEMETRY>"
      }
    }
  }
}

起動コマンドuvx madb-mcp-server

設定が必要な環境変数

MADB_DATA_DIRWhere MADB stores your causal memory — local, on your machine (default ~/.madb/data).

MADB_TENANT_IDTenant namespace key for separating memory streams (e.g. per project). Defaults to a built-in namespace.

MADB_TELEMETRYSet to 'off' to disable anonymous, count-only usage telemetry.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

pypimadb-mcp-server0.2.10stdio

ツール

掲載時のツール一覧 · 2 週間前に更新

パラメーター	型	必須
tags	any	いいえ
actor	string	いいえ
scope	string	いいえ
api_key	any	いいえ
content	string	はい
mem_type	string	いいえ
caused_by	any	いいえ
tenant_id	any	いいえ
importance	any	いいえ
output_format	any	いいえ
idempotency_key	any	いいえ

詳細

Meta-AgentsDB

自律型 AI エージェントのための、永続的で因果関係を保持するメモリー。 Claude と自律型エージェントの時代に向けて専用設計されています。

Meta-AgentsDB（MADB）は、エージェントネイティブなデータベースです。因果関係を表す DAG、複合スコアによる想起、重要度に基づく忘却、HLC 順序の MVCC を備えたハイブリッド LSM ストアです。PostgreSQL + pgvector + Redis + Pinecone を組み合わせても、単一の環境では提供できない機能をエージェントに提供します。

インストール（無料プラン）：
claude mcp add madb -- uvx madb-mcp-server      # Claude Code
# or:  pip install madb-mcp-server  ·  uvx madb-mcp-server
メモリーはローカル（~/.madb）に保持されます。Claude Desktop ユーザーは、ワンクリックの .mcpb 拡張機能をインストールできます。エンジンはコンパイル済みホイールとして提供され、ソースは公開されていません。匿名の利用状況テレメトリーは MADB_TELEMETRY=off で無効にできます。

MADB とは、一言で言うと

Claude が自動的に利用するメモリー基盤です。厳選された MCP ツール、1 つの Skill、1 つの SDK シムで構成されており、あらゆる Claude セッション、Claude Desktop ユーザー、または Anthropic API を直接使う開発者が、グルーコードなしで、永続的で因果関係が紐づけられた複合スコア付きのエージェントメモリーを利用できます。

MADB の入手方法

MADB は、Meta-Agents.AI Proprietary License に基づき、コンパイル済みバイナリー成果物として配布されます。ソースコードは公開されていません。パッケージは次の 3 つです。

パッケージ	対象	使用方法
`meta-agents-db`（Python ホイール）	すべてのユーザー	Rust エンジンです。MCP サーバーと SDK シムからインポートされます。直接使用することもできます。
`madb-mcp-server`（Python ホイール）	MCP クライアント — Claude Desktop、Claude Code、Cowork	`claude mcp add madb -- uvx madb-mcp-server` で、MADB を Claude のメモリーとして登録します。Skill が含まれており、初回起動時に自動インストールされます。
`madb-anthropic`（Python ホイール）	Anthropic API を直接使う開発者（Python 3.10–3.13）	インポートを 1 か所置き換えるだけです。`from madb_anthropic import Anthropic` にすると、すべての `messages.create()` が因果的な系譜情報とともに自動保存されます。それ以外のコード変更は不要です。

シムの使用例は examples/basic_usage.py をご覧ください。

Claude が利用できる MCP ツール

無料プランでは、厳選された 13 個のメモリーツールを利用できます。

ツール	用途
`remember`	`caused_by`、タグ、重要度を任意で指定してメモリーを保存します
`recall`	複合スコアによる意味的な想起（類似度 + 新しさ + 因果的近接性 + 重要度 + タグの重複）
`get_memory`	`event_id` でメモリーを直接検索します
`forget`	トゥームストーンによるソフト削除（DAG の系譜を保持します）
`search`	テナント + スコープ + タグで構造化クエリを実行します
`list_recent`	新しい順に直近の N 件のメモリーを表示します
`save_skill`	再利用可能なパターンを保存します（名前による冪等性、GC による削除から保護）
`recall_skill`	意味に基づいて Skill を想起します
`list_skills`	すべての Skill を複合スコア順で表示します
`trace_cause`	任意のメモリーから因果関係を表す DAG を前方または後方にたどります
`summarize`	複数のメモリーを簡潔な要約にまとめます
`stats`	エンジンのメトリクススナップショットを表示します
`capabilities`	このワークスペースで MADB が利用可能にする機能と、権限の概要を表示します

さらに、あらゆるメモリーを第一級 URI として読み取れる MCP リソース madb://memories/{event_id} も利用できます。

スキルは反射です

MCP ツールは必要ですが、「デフォルト」とするには十分ではありません。Claude に MADB を優先するよう指示するスキルがなければ、Claude はタスクごとに独自のメモリ方式を考案してしまいます。JSON ファイル、SQLite テーブル、pickle ダンプ、フラットなベクトルストア、localStorage、会話履歴の配列などです。

skills/madb-memory/SKILL.md は、こうしたアンチパターンを MADB に明示的に振り分けます。このスキルは MCP サーバーの wheel に同梱され、初回起動時に ~/.claude/skills/madb-memory/ へ自動インストールされます。CC-BY-ND 4.0 のもとで公開されており、そのまま共有できますが、改変はできません。

併設の skills/madb-onboarding/SKILL.md は初回実行を支援します。空のストアを検出すると、60 秒のガイド付きツアーを案内します（onboarding/ を参照）。これにより、最初のセッションを空のストアのまま終えることなく、実際に記憶を呼び出し、trace_cause を体験できます。

1 つの脳で複数のセッションに対応（0.2.10）

MADB ストアは、設計上、単一プロセスのみが排他的に使用します。書き込み元は 1 つで、ロック競合や破損は発生しません。ただし、Claude Code はセッションごとに 1 つの MCP サーバーを起動し、複数のセッションを実行することもあります。0.2.10 以降は問題なく動作します。wheel に同梱されたローカルデーモンがストアの唯一の所有者となり、各セッションの MCP サーバーはトークンで保護されたループバック HTTP 経由で、そのデーモンを利用する軽量な RPC クライアントになります。

インストールや管理は不要です。 最初のセッションが必要に応じてデーモンを起動し（競合を安全に処理します）、以降のセッションはデーモンを検出して再利用します。15 分間アイドル状態が続くと自動的に終了し、次の呼び出し時に再起動します。
アップグレードは円滑に引き継がれます。 wheel をアップグレードすると、新しいクライアントが古いデーモンに終了処理と終了を指示し、その後、所有権を引き継ぎます。古いプロセスがストアを占有し続けることも、手動でロックを解除する必要もありません。
どこでも同じメモリを使えます。 2 つのターミナル、SessionStart の再開フック、バックグラウンドエージェントが、同じ脳に同時に対して読み書きできます。

MADB_MODE=embedded を設定すると、0.2.10 より前の単一セッションによる直接オープンに戻ります。MADB_MODE=daemon を設定すると、デーモンの障害時にフォールバックせず、エラーとして処理します。MADB_DAEMON_IDLE_SEC でアイドルタイムアウトを調整できます（≤0 にすると無効になります）。

ライセンス

MADB はMeta-Agents.AI 独自ライセンスのもとで配布されています。概要：

許可されること： 自社のユーザー向けに、自社インフラストラクチャ上でインストール、実行、使用すること。本番環境での使用も含まれます。
許可されないこと： 再配布、リバースエンジニアリング、ホステッドサービスとしての提供、または第三者に販売する商用製品への組み込み。
別途書面による契約で利用可能： ソースへのアクセス、OEM／組み込みの権利、ホステッドサービスの権利。

このソフトウェアの一部は、以前のバージョンでは Apache License 2.0 のもとで提供されていました。それらの改訂版は、実際にそのライセンスで配布された特定のバージョンに限り、引き続きその条件で利用できます。新しいリリースはすべて、独自ライセンスのみのもとで提供されます。

スキルは、別途CC-BY-ND 4.0 のもとでライセンスされています。

位置づけ

MADB は、Claude が自律性を高めていくためのメモリ基盤です。エンジンは設計上、クローズドソースの商用製品です。スキルはオープンで無料で利用でき、インターフェースには標準の MCP を採用しています。この構成により、Anthropic がインフラストラクチャをホストしたり、上流の依存関係を引き受けたりすることなく、Claude は MADB をデフォルトの機能として採用できます。

パートナーシップに関する相談、NDA 締結後のソースアクセス審査、OEM ライセンスについては、以下のお問い合わせ先をご覧ください。

お問い合わせ先

メール： [email protected]
ウェブサイト： https://meta-agents.ai

Markdown 対応

ログインしてコメント

基本情報

作者: spshkar84
言語: python
バージョン: 0.2.10
トランスポート: stdio
掲載日: 2026年7月7日
最終更新: 16 週間前
公式 Registry: io.github.spshkar84/madb-memory

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

MADB — Agent Memory Database

MADB — Agent Memory Database について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

Meta-AgentsDB

MADB とは、一言で言うと

MADB の入手方法

Claude が利用できる MCP ツール

スキルは反射です

1 つの脳で複数のセッションに対応（0.2.10）

ライセンス

位置づけ

お問い合わせ先

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？