neurohive

neurohive

AI エージェントチーム向けのマルチエージェント・メモリーインテリジェンス — 共有ナレッジ、専門知識の追跡、矛盾の検出を実現します。

理由

チーム内の AI エージェントは、すべてを忘れ、ナレッジを共有できません。同じプロジェクトで作業する複数のエージェントが、同じ事実を何度も発見し、互いに矛盾し、チーム全体のメモリーを持てません。あるエージェントは API のタイムアウトが 30 秒だと学び、別のエージェントは 60 秒だと想定します。どちらの結論も別々のセッションに残り、照合されることはありません。

neurohive は neuromcp を共有インテリジェンスレイヤーで拡張します。いずれかのエージェントが保存したすべてのメモリーが、チーム内で参照できるようになります。検索結果には、誰がいつ発見したかが注釈として表示されます。新しいエージェントは、チームがすでに持つナレッジを読み込んだ状態で参加できます。矛盾は、インシデントにつながる前に検出されます。

導入前と導入後

	neuromcp のみ	neurohive を使用
エージェントのナレッジ	セッションごとに分離	チームで共有し、出所を記録
検索結果	生の結果	「Agent-X が 3 分前に発見」などの注釈付き
新しいエージェントのオンボーディング	ゼロから開始	チームの主要なナレッジを事前に読み込み
専門知識	誰が何を知っているか不明	「Agent-Backend：API（31）、Auth（22）」のように追跡
矛盾	気付かれずに共存	「Backend はタイムアウト 30 秒、DevOps は 60 秒と主張」のように検出
チームの概要	なし	ナレッジマップ、ギャップ、アクティビティを示すダッシュボード

クイックスタート

npx neurohive

npx neuromcp のドロップイン置き換えです。同じ MCP 設定を使用し、コマンドだけを置き換えます。neuromcp のすべてのツールとリソースはそのまま利用でき、さらに neurohive の新しいツール 3 つ、新しいリソース 5 つ、およびエージェント間の自動注釈が追加されます。

機能

エージェント間の注釈

すべての検索結果に、どのエージェントが保存したか、どのくらい前か、何回取得されたかといった出所情報が注釈として付与されます。エージェントは、メモリーが信頼できるチームメイトからのものか、未知のソースからのものかをすぐに確認できます。

エージェントの事前読み込み

エージェントは起動時に hivemind://priming リソースを読み込み、チームの主要なナレッジ、最近のアクティビティ、既知のギャップを取得します。初期状態からのスタートはありません。

専門知識の追跡

エージェントがメモリーを保存するたびに、neurohive はそのエージェントの専門知識プロファイルを更新し、どのカテゴリへの貢献が多いかを追跡します。hivemind_expertise を使って質問の振り分けに活用できます。「認証について最も詳しいのは誰ですか？」

矛盾の検出

2 つのエージェントが同じ事実について矛盾する主張を保存すると、neurohive は矛盾として検出します。矛盾は hivemind_conflicts とダッシュボードに表示されるため、古いデータが気付かれずに広がるのを防ぎ、チームが明示的に解決できます。

ダッシュボード

1 つのコマンドで、チーム全体のナレッジベースをリアルタイムで確認できます。メモリーの合計数、アクティブなエージェント、主要なカテゴリ、最近のアクティビティ、未解決の矛盾、ナレッジのギャップが表示されます。

インストール

Claude Code

{
  "mcpServers": {
    "neurohive": {
      "command": "npx",
      "args": ["neurohive"],
      "env": {
        "HIVEMIND_COMPANY": "my-project",
        "HIVEMIND_AGENT": "Agent-Backend",
        "HIVEMIND_AGENT_ROLE": "backend"
      }
    }
  }
}

Claude Desktop

{
  "mcpServers": {
    "neurohive": {
      "command": "npx",
      "args": ["-y", "neurohive"],
      "env": {
        "HIVEMIND_COMPANY": "my-project",
        "HIVEMIND_AGENT": "Agent-Frontend"
      }
    }
  }
}

Cursor

{
  "mcpServers": {
    "neurohive": {
      "command": "npx",
      "args": ["neurohive"],
      "env": {
        "HIVEMIND_COMPANY": "my-project",
        "HIVEMIND_AGENT": "Cursor-Agent"
      }
    }
  }
}

Paperclip モード

Paperclip がローカルで実行されている場合、neurohive は自動的に検出し、Paperclip API から会社、エージェント、役割を読み取ります。追加の環境変数は不要です。会社の名前空間はアクティブな Paperclip の会社から設定され、各エージェントは Paperclip の ID で識別されます。

手動での代替設定（Paperclip が実行されていない場合）：

HIVEMIND_PAPERCLIP_URL=http://localhost:3100   # default
HIVEMIND_COMPANY=my-project
HIVEMIND_AGENT=Agent-Backend
HIVEMIND_AGENT_ROLE=backend

CLI コマンド

コマンド	説明
neurohive	MCP サーバーとして起動（stdio）
neurohive dashboard	チームのナレッジダッシュボードを表示
neurohive expertise [topic|agent_id]	専門知識マップを表示、またはトピック／エージェントを検索
neurohive conflicts [--all]	未解決の矛盾を一覧表示（--all では解決済みも含む）
neurohive doctor	ヘルスチェック：DB パス、エージェント設定、Paperclip のステータス

設定

neurohive variables

変数	デフォルト	説明
HIVEMIND_COMPANY	""	会社／プロジェクト名です。共有名前空間を company-<name> に設定します
HIVEMIND_AGENT	""	エージェント識別子です（例：Agent-Backend、Agent-DevOps）
HIVEMIND_AGENT_ROLE	""	コンテキストの初期設定に使用するエージェントの役割ラベルです
HIVEMIND_PAPERCLIP_URL	http://localhost:3100	自動検出用の Paperclip API URL です
HIVEMIND_PRIMING_COUNT	10	初期設定コンテキストに含める上位メモリーの数です
HIVEMIND_PRIMING_CATEGORIES	""	初期設定で優先するカテゴリーをカンマ区切りで指定します

neuromcp pass-through

すべての NEUROMCP_* 環境変数は変更されずに引き継がれます。主な変数は次のとおりです。

変数	デフォルト	説明
NEUROMCP_DB_PATH	~/.neuromcp/memory.db	SQLite データベースのパスです
NEUROMCP_LOG_LEVEL	info	ログレベル：debug、info、warn、error
NEUROMCP_EMBEDDING_PROVIDER	local	埋め込みプロバイダー：local、openai、ollama
OPENAI_API_KEY	—	OpenAI の埋め込みを使用する場合に必要です

MCP Surface

neurohive は、16 個のツール、18 個のリソース、3 個のプロンプトを公開します。

Tools

13 個の neuromcp ツール（変更なし）：

ツール	説明
store_memory	hive の注釈付きでメモリーを保存します
search_memory	エージェント間の属性情報を含むハイブリッド検索を行います
recall_memory	ID、名前空間、カテゴリー、またはタグでメモリーを呼び出します
forget_memory	フィルターでメモリーを論理削除します
consolidate	重複を統合し、古いデータを減衰させ、価値の低いデータを整理します
memory_stats	件数、カテゴリー、信頼レベルの統計情報を取得します
export_memories	JSONL または JSON としてエクスポートします
import_memories	重複を排除してインポートします
backfill_embeddings	欠落している埋め込みを再計算します
create_entity	ナレッジグラフのエンティティを作成／更新します
create_relation	ナレッジグラフ内のエンティティをリンクします
query_graph	ナレッジグラフをたどります
search_claims	抽出された原子的な主張を検索します

3 個の neurohive ツール：

ツール	説明
hivemind_status	チームダッシュボード：エージェント、カテゴリー、競合、アクティビティ
hivemind_expertise	誰が何を知っているかを照会し、エージェントの専門知識プロフィールを取得します
hivemind_conflicts	エージェント間の矛盾を一覧表示／解決します

Resources

13 個の neuromcp リソース（メモリー、グラフ、初期設定、統計情報）に加え、5 個の neurohive リソース：

リソース URI	説明
hivemind://priming	起動時のコンテキスト：オンボーディング用のダッシュボードと主要なナレッジ
hivemind://expertise	すべてのエージェントの専門知識データ（JSON）
hivemind://conflicts	未解決の競合（JSON）
hivemind://dashboard	ダッシュボードの全データ（JSON）
hivemind://agent/{agentId}	特定のエージェントの専門知識プロフィール

Prompts

3 個の neuromcp プロンプト：store_memory_prompt、search_memory_prompt、session_summary_prompt。

Paperclip Integration

neurohive は起動時に HIVEMIND_PAPERCLIP_URL を確認します。Paperclip API が応答した場合：

1. 名前空間が company-<companyId> に設定されます。同じ Paperclip 会社に属するすべてのエージェントが、1 つのナレッジベースを共有します。
2. エージェントの識別情報が Paperclip のエージェントレコードから読み込まれるため、フリート内の各エージェントが自動的に識別されます。
3. 役割がエージェント定義から取得され、初期設定コンテキストを充実させるために使用されます（「あなたはバックエンドエージェントです。チームが把握している情報はこちらです」）。

Paperclip が実行されていない場合、neurohive は HIVEMIND_COMPANY／HIVEMIND_AGENT 環境変数にフォールバックし、機能はすべてそのまま利用できます。

Requirements

要件	必須	備考
Node.js >= 18	はい	ESM ランタイム
neuromcp	はい	依存関係として自動的にインストールされます
Paperclip	いいえ	設定された URL で実行中の場合、自動検出されます
OpenAI API key	いいえ	OpenAI の埋め込みを使用する場合のみ必要です

プラットフォームのサポート

プラットフォーム	ステータス
macOS	完全サポート
Linux	完全サポート
WSL2	サポート対象
Windows (native)	サポート対象外

FAQ

これは neuromcp の代替ですか？ はい、そしていいえです。neurohive は neuromcp の上で動作し、neuromcp のすべてのツール、リソース、プロンプトを再エクスポートします。エージェントを 1 つだけ実行する場合、追加のツールがいくつかある点を除けば、機能は neuromcp と同じです。2 つ以上のエージェントが同じ HIVEMIND_COMPANY 名前空間を共有すると、その価値が発揮されます。

すべてのエージェントが 1 つのデータベースを共有しますか？ はい。同じ企業名前空間に属するエージェントは、共有ファイルシステムパス（NEUROMCP_DB_PATH）を介してデータベースを共有します。同じマシン上でのマルチエージェント構成（Paperclip、dmux、Claude Code の並列セッションなど）では、自然に動作します。分散構成では、すべてのエージェントが共有 NFS またはネットワーク上のパスを参照するように設定してください。

何が競合に該当しますか？ 異なるエージェントの 2 つの記憶が、同じ対象について矛盾する主張をする場合です。競合検出は、記憶の内容から抽出された認知的主張を使って、保存時に実行されます。感度の調整や無効化は、neuromcp の設定から行えます。

既存の neuromcp の設定が壊れますか？ いいえ。neurohive は既存の NEUROMCP_* 環境変数を変更せずにすべて引き継ぎ、同じデータベースに書き込みます。いつでも npx neuromcp に戻せます。

プライミングはどのように動作しますか？ 起動時に hivemind://priming を読み取るエージェントには、チームの規模、上位カテゴリ、最もアクティブなエージェント、最近の記憶、未解決の競合をまとめた形式化済みの要約が届きます。これはシステムプロンプトに含めるか、セッション開始時にフック経由で読み取ることを想定しています。

貢献

CONTRIBUTING.md を参照してください。

ライセンス

MIT — LICENSE を参照してください。