Memory Hive

memory-hive-mcp

AI エージェントが MCP 経由で共有する、ローカルファーストのメモリです。エージェントは提案し、確定するのはあなたです。

memory-hive-mcp は、薄型の Model Context Protocol サーバーです。 MCP 対応ホスト（Claude Desktop、Cursor など）から、あなたのメモリを読み書きできます。メモリはあなたのコンピューター上に保存され、あなたの Hive によって管理され、どこにもアップロードされません。

このパッケージにメモリエンジンは含まれていません。 お使いのマシン上ですでに実行中の Hive アプリ（127.0.0.1:8768）に、MCP プロトコルの通信を中継します。保存状態としてデータがこのブリッジを通過することはなく、コンピューターの外に送信されることもありません。

解決する課題

現在では、主要なアシスタントはどれもセッションをまたいだメモリを備えているため、「AI に記憶がない」という問題はもうありません。問題は、それに取って代わったものです。メモリはベンダーごとに分断され、エクスポートできない形式で保存され、あなたが設定していないポリシーによって管理されています。

	Hive なし	Hive あり
メモリの保存場所	各ベンダーのサーバー	あなたのマシン上のファイル
クライアントの切り替え	何もない状態からやり直し	同じメモリを、どの MCP クライアントからでも利用
書き込みできるユーザー	モデルが黙って書き込み	モデルは propose しかできず、確定するのはあなた
エクスポート	「すべて削除」ボタン	すでにあなたのディスク上にあります
3 つのアシスタントの利用	不完全なメモリが 3 つ、どれもあなたのものではない	1 つのメモリを 3 つのリーダーが利用

対象ユーザー： 2 つ以上の AI アシスタントを使っていて、毎回自分のことを説明し直すのが煩わしいと感じる方です。アシスタントを 1 つしか使わない場合は、ベンダー内蔵のメモリで十分でしょう。

インストール

pip install memory-hive-mcp

Python 3.8 以上が必要です。サードパーティ製の依存関係はありません。コマンド memory-hive-mcp がインストールされます。

（注：PyPI では、無関係なプロジェクトが hive-mcp という名前を使用しています。これは当プロジェクトではありません。）

前提条件：Hive が実行中であること

memory-hive-mcp は、お使いのマシン上の Hive と通信します。Mac App Store から入手してください。

https://apps.apple.com/app/id6806992983

次に、Hive 内でエージェントを登録し（POST /api/agent/register）、agent_id と access_token を取得してください。

Hive 1.4.5 以降が必要です。 1.4.4 以前には say および board ツールがありません。1.4.4 以前では最初の 4 つのツールのみが利用可能で、say または board を呼び出すと失敗します。

このパッケージ単体では動作しません。 メモリエンジン、データベース、インデックスは含まれておらず、MCP 通信を中継するだけです。Hive アプリがインストールされ、実行されていない場合、接続先のないブリッジにつながります。スタンドアロンのメモリサーバーとして使えると思ってインストールする人がいないよう、この制限は意図的にここで説明し、目立たない場所に隠していません。

現在、Hive アプリは macOS 専用です。ブリッジ自体は純粋な Python で、どこでも実行できますが、通信先となる Hive が必要です。

Hive が実行されていない場合の動作

MCP メソッド	Hive が実行されていない場合
initialize	ローカルで応答します。ハンドシェイクが完了し、プロトコルは 2024-11-05 です。
tools/list	ローカルで応答し、以下のツールが一覧表示されます。
tools/call	HIVE_MCP_URL と App Store のリンクを明示したエラーで失敗します。 結果を捏造することはありません。

Hive が実行中の場合、initialize と tools/list は Hive 自体が応答するため、表示されるツール一覧、その制約、プロトコルのバージョンは常に実際のものです。

つまり、ディレクトリクローラー、CI チェック、あるいは興味本位の pip install でも、Hive のないマシン上でツールのインターフェイスを確認できます。一方、実際のメモリ操作は、成功したふりをせず、正直に失敗します。空の結果を捏造するより、エラーを返すほうが適切です。そうしなければ、呼び出し元はユーザーのメモリが空だと判断してしまいます。

MCP ホストの設定

ホストの MCP 設定にサーバーを追加します。Claude Desktop の場合（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "hive-memory": {
      "command": "memory-hive-mcp",
      "env": {
        "HIVE_AGENT_ID": "your-agent-id",
        "HIVE_AGENT_TOKEN": "your-access-token"
      }
    }
  }
}

環境変数

名前	必須	説明
HIVE_AGENT_ID	はい	ご自身の Hive が発行したエージェント ID です。
HIVE_AGENT_TOKEN	はい	エージェントの登録時に発行されたアクセストークンです。秘密にしてください。
HIVE_MCP_URL	いいえ	Hive MCP エンドポイントです。既定値は http://127.0.0.1:8768/mcp です。

6 つのツール

すべてのツールで MCP アノテーションが宣言されているため、ホストは説明を読む前に安全性プロファイルを把握できます。recall、get_context、board は読み取り専用です。propose と manage は読み取り専用ではありませんが、どちらも破壊的操作としてマークされていません（manage は discard_pending を除くすべての操作を元に戻せます）。 いずれもオープンインターネットには接続せず、ブリッジはローカルの Hive とのみ通信します。

ツール	方向	機能
recall	読み取り	確認済みのメモリをセマンティック検索します。{"query": "...", "limit": 10, "compact": true} — vaults を指定すると検索対象を絞り込み、query_vector を指定すると埋め込みによる検索に切り替わります。特定の質問にはこちらを使い、セッション開始時には代わりに get_context を、未承認の項目を確認するには manage list_pending を使います。
propose	書き込み → 保留中	承認を求めるメモリを送信します。{"content": "..."} に加えて、任意で title、vault、tags、vector、冪等性キーとしての client_id を指定できます。類似した項目がある場合は conflict_warning を返します。成功応答はキューに追加されたことを意味し、保存されたわけではありません — 承認されるまで保留中のままです。
manage	管理	action に応じて処理します：list_pending ／ forget（ソフト削除。restore で復元可能）／ restore ／ get_by_id ／ discard_pending（唯一の取り消し不能な操作）。ID またはキューの状態を指定します — トピックで検索するには recall を使います。
get_context	セッション開始	アクティブなスレッドや未完了のタスクから最近のメモリを取得し、会話の初期情報として設定します。{"limit": 8}。クエリではなく新しさに基づきます。特定の質問には recall を使います。
say	コラボレーション	共有ボードに投稿します。{"summary": "..."} に加えて、任意で to、kind（data／handoff／result）、stage（start／handoff／done／blocked）、task_id、refs、ttl を指定できます。Hive 1.4.5 以降が必要です。ボードを読むには board を使います。
board	コラボレーション	カーソルを使って共有ボードを読み取ります。{"limit": 20, "since": "<cursor>"} — roster: true を指定すると、現在対応中のメンバーも返されます。メッセージは期限切れになるため、結果が空でも、メッセージの保存期間が過ぎた可能性があります。Hive 1.4.5 以降が必要です。

一般的なセッションの流れ：開始時に get_context → 会話の途中で recall → 「これを残して」と言うと propose が実行される → Mac 上の Hive で確認します。

共有ストアだけではなく、共有台帳

say と board によって、Hive は単なるメモリテーブルではなく、複数のエージェントと 1 人の人間が同じ台帳を共有する場所になります。

エージェントが完了した作業を投稿し（say）、別のエージェントが自分のスケジュールに合わせてカーソル付きで取得します（board）— プッシュ通知も、誰かを起こすことも、間にオーケストレーターを挟むこともありません。 ID は呼び出し元が設定できるフィールドではなく、認証情報によって決まるため、あるエージェントが別のエージェントになりすまして発言することはできず、人間はすべての引き継ぎを同じスレッドで確認できます。

エージェントは提案できますが、決定はできません。

この設計こそが、このサーバーをメモリキャッシュと区別する点です。

エージェントはメモリを propose できますが、承認することはできません。 書き込まれた内容は保留キューに入り、あなた が自分の Hive 内で承認するまでそこに留まります。 self-confirm も、バックグラウンドでの非通知書き込みも、モデルがあなたについての真実をひそかに決める手段もありません。

メモリは Vault に分割され、その境界はプロンプト上の約束ではなく、Hive によってサーバー側で確認され、強制されます。

エージェントの種類	パブリック Vault	プライベート Vault
クラウドエージェント（mcp ／ mobile）	✅ オープン	🔒 封印
ローカルエージェント（クラウド以外）	✅ オープン	✅ オープン

登録テーブルにないエージェントは、既定で封印されます。プライベート Vault の項目は、閲覧を許可されていないエージェントから読み取り、削除、復元できません。

なぜバンドルではなくブリッジなのか

メモリーを書き込むのは、お使いのマシン上の Hive だけであるべきです。そのため、このサーバーはプロトコルだけを扱います。データファイルを開くことも、状態をキャッシュすることも、エンジンを複製することもありません。これにより、メモリーを一元化し、ローカルに保ち、お客様の管理下に置くことができます。

ステータス

アルファ版（0.x）です。通信プロトコルは安定していますが、設定やツールのシグネチャは今後変更される可能性があります。バージョン間の変更内容については、CHANGELOG.md をご覧ください。

プラットフォーム。 このブリッジが接続するメモリーエンジンである Hive アプリは、現在 macOS 向けに提供されています — App Store。Windows および Linux 版は開発中です。ブリッジ自体は純粋な Python で書かれているため、どこでも実行できますが、接続先となる Hive が必要です。

ベンチマークはありません。 検索ベンチマークは意図的に公開していません。検索のランキングでは、用途に特化したベクトルストアに勝てないでしょうし、私たちはそのような主張もしていません。私たちが主張するのは、より限定的で検証可能なことです。データはお使いのマシンに保たれ、書き込み権限はお客様が保持します。

リンク

• リポジトリ: https://github.com/330899935/memory-hive-mcp
• プロジェクトホーム: https://hello-fengchao.com
• MCP 統合ドキュメント: https://hello-fengchao.com/mcp.html
• パッケージ: https://pypi.org/project/memory-hive-mcp/
• セキュリティポリシー: SECURITY.md

ライセンス

MIT