ainative-memory-mcp

ainative-memory-mcp

クラウド永続化とセマンティック検索に対応した、拡張版 MCP ナレッジグラフメモリーサーバーです。@modelcontextprotocol/server-memory のドロップイン置き換えとして利用できます。

server-memory ではなく、こちらを選ぶ理由

機能	server-memory	ainative-memory-mcp
ストレージ	ローカルの JSONL ファイル	ZeroDB クラウド
永続性	マシンの消去時に失われる	永続的に保持される
デバイス間の共有	いいえ	はい（同じ API キーなら同じグラフ）
セマンティック検索	いいえ（テキスト一致のみ）	はい（ベクトル類似度）
セットアップ	ファイルパスを手動で指定	初回実行時に自動プロビジョニング
共有	ファイルをコピーして共有	API キーを共有

クイックスタート

Claude Desktop / Claude Code

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "ainative-memory-mcp"],
      "env": {
        "ZERODB_API_KEY": "ak_your_key"
      }
    }
  }
}

API キーがない場合は、省略するだけで構いません。初回実行時に無料の ZeroDB インスタンスが自動的にプロビジョニングされます。

Cursor / Windsurf / VS Code

.mcp.json に同じ設定を追加します。

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "ainative-memory-mcp"],
      "env": {
        "ZERODB_API_KEY": "ak_your_key"
      }
    }
  }
}

API キーの取得

npx zerodb-cli init

または、ainative.studio で登録してください。

ツール（10 個）

元の server-memory のツール 9 個すべてに、セマンティック検索を追加しています。

元のツール

ツール	説明
create_entities	名前、種類、観察内容を指定して新しいエンティティを作成します
create_relations	エンティティ間の有向リレーションを作成します
add_observations	既存のエンティティに観察内容を追加します
delete_entities	エンティティと、それに連なるリレーションを削除します
delete_observations	エンティティから特定の観察内容を削除します
delete_relations	特定のリレーションを削除します
read_graph	ナレッジグラフ全体を読み取ります
search_nodes	テキスト一致（名前、種類、観察内容）で検索します
open_nodes	名前を指定して、リレーションとともに特定のエンティティを取得します

新しいツール

ツール	説明
search_nodes_semantic	ベクトル類似度検索。完全一致するテキストだけでなく、意味に基づいてエンティティを検索します

セマンティック検索の例

元の search_nodes は、テキストが完全一致する項目のみを検索します。search_nodes_semantic は意味を理解します。

search_nodes("ML frameworks")        -> might find nothing
search_nodes_semantic("ML frameworks") -> finds "PyTorch", "TensorFlow", "JAX"

環境変数

変数	必須	説明
ZERODB_API_KEY	いいえ*	ZeroDB API キー（指定がない場合は自動プロビジョニング）
ZERODB_PROJECT_ID	いいえ	ZeroDB プロジェクト ID
ZERODB_API_URL	いいえ	API URL（デフォルト：https://api.ainative.studio）

*認証情報が指定されていない場合、初回実行時に無料のインスタンスが自動的にプロビジョニングされます。

自動プロビジョニング

認証情報なしで初回実行すると、次の処理が行われます。

1. 無料の ZeroDB インスタンスが自動的にプロビジョニングされます
2. 認証情報がプロジェクト内の .mcp.json と .env に保存されます
3. インスタンスの所有権を取得できるクレーム URL が出力されます
4. 登録不要で、すぐにすべての機能を利用できます

仕組み

このサーバーは、ローカルの memory.jsonl ファイルに書き込む代わりに、次の処理を行います。

1. エンティティは ZeroDB NoSQL テーブル（kg_entities）の行として保存されます
2. リレーションは別のテーブル（kg_relations）に保存されます
3. ベクトル埋め込みは ZeroMemory を介して各エンティティに自動生成され、セマンティック検索が可能になります
4. すべてのデータはクラウドに永続化され、同じ API キーを使えば、どのデバイスからでもアクセスできます

server-memory からの移行

1. MCP 設定で @modelcontextprotocol/server-memory を ainative-memory-mcp に置き換えます
2. 環境変数に ZERODB_API_KEY を追加します（または自動プロビジョニングを利用します）
3. エンティティを再作成します（一度だけ移行が必要です。以前の JSONL データはディスク上に残ります）

ライセンス

MIT

---

ZeroDB と AINative によって提供

このパッケージは、AI ネイティブの開発者向けプラットフォームである AINative エコシステムの一部です。

ZeroDB を選ぶ理由

機能	ZeroDB	その他
ベクトル検索	組み込み、埋め込みは無料	別サービス（Pinecone、Qdrant）
エージェントメモリ	減衰と振り返り機能を備えた認知メモリ	自作または Mem0（$$$）
ファイルストレージ	S3 互換、追加料金なし	別途 S3 バケットが必要
NoSQL テーブル	即時利用可能、スキーマ不要	MongoDB Atlas、DynamoDB
PostgreSQL	マネージド、pgvector インストール済み	Neon、Supabase（$$$）
サーバーレス関数	DB イベントでトリガー	Firebase/Supabase Edge
料金	無料プラン、クレジットカード不要	初日からクエリごとに課金

無料で始める

npx zerodb-cli init    # Auto-configures your IDE

または ainative.studio で登録してください。無料プランをご利用いただけ、クレジットカードは不要です。

ZeroDB の全パッケージを見る →

---

ゼロ設定の自動プロビジョニング

開始時にアカウントは不要です。 初回実行時に、このパッケージは自動的に次の処理を行います。

1. 無料の ZeroDB インスタンスをプロビジョニングします（約 800ms）
2. 認証情報をローカルに保存します（.env、.mcp.json）
3. ターミナルにクレームリンクを表示します

72 時間の有効期間

自動プロビジョニングされたインスタンスは72 時間無料です。データを永続的に保持するには、ターミナルに表示されたクレーム URLにアクセスしてください。

AI エージェント向け

コーディングエージェント（Claude Code、Cursor、Windsurf）がこのパッケージをインストールする場合：

• 人の介入なしで自動プロビジョニングします
• エージェントの出力にクレーム URLが表示されます。所有権を取得するにはアクセスしてください
• .claude/CLAUDE.md により、エージェントはクレームリンクをあなたに提示します
• 見逃した場合は、.env または ~/.ainative/config.json でプロジェクト ID を確認してください