Hiberden

hiberden-mcp：Hiberden MCP サーバー

Hiberden アーカイブエンジン（hiberden-core）を、stdio トランスポート上のModel Context Protocolツールとして公開します（改行区切りの JSON-RPC 2.0）。

MCP はオープンでベンダー中立の標準であるため、このサーバーはあらゆる MCP クライアントから利用できます。Claude Desktop / Claude Code、OpenAI の Agents SDK と ChatGPT デスクトップアプリ、Gemini、Cursor、Windsurf などに対応しています。このプロセスにはモデルも API キーもありません。LLM はクライアント側で用意され、このバイナリはローカルカタログに対するツール呼び出しに応答するだけです。デフォルトモードでは、ネットワーク I/O は一切行いません。

デフォルトでは読み取りと検証のみ

サーバーはデフォルトで、以下の読み取り／検証ツールを公開して応答し、設定を変更することはありません。デフォルトのツールが書き込む状態は、verify_copy が記録する内容だけです。具体的には、コピーのステータス、検証パスの来歴（実行されたアルゴリズムと、最後に全件検証に成功した日時）、および完了した検証ごとの監査ログ行です。また、これらを記録するのは、メディアから実際に読み戻した後に限られます。

書き込みおよび削除ツール（カタログ管理、保存先、ポリシー）も実装されていますが、カタログに保存される権限レベルの背後にあり、デフォルトでは読み取り専用です。変更できるのは Hiberden デスクトップアプリの設定からのみです。有効な権限レベルを超えるツールは、公開も受け付けもされません。docs/Hiberden_MCP_Command_Surface_and_Permission_Model.md（docs/mcp/write-gate-design.md に代わるドキュメント）を参照してください。

読み取り・検証ツール（常時有効）

ツール	引数	説明
list_projects	なし	最上位のプロジェクト（コンテナー）を一覧表示します。それぞれについて、名前、ポリシー、アーカイブ数、および各カバレッジ状態にあるアーカイブ数の集計を表示します。
list_archives	project_id?, collection_id?, name?	アーカイブ（実際にメディアに書き込まれた末端要素）を一覧表示します。それぞれについて、プロジェクト、サイズ、SHA-256、3-2-1 カバレッジ、およびコピーごとの状態（保存先＋種類＋状態）を表示します。プロジェクト、コレクション、および／または大文字と小文字を区別しない名前の部分文字列で絞り込みます。
list_collections	project_id	1 つのプロジェクト内のコレクション（カタログのみの整理用ノード）を一覧表示します。id、名前、親、アーカイブ数を表示します。
coverage_status	なし	ライブラリ全体の 3-2-1 カバレッジ集計を表示します。アーカイブの合計数と、未設定、未保護、進行中、リスクあり、完全カバー済みの各状態の数を表示します。
archive_detail	archive_id	1 つのアーカイブの詳細をすべて表示します。プロジェクト、サイズ、SHA-256、旧形式の MD5（インポートされている場合）、カバレッジ、および保存先、種類、状態、アドレス、書き込み・検証タイムスタンプを含むすべてのコピーを表示します。
list_destinations	なし	設定済みの保存先（Tape、LocalFs、NAS、Cloud）を一覧表示します。id、スロット、種類、名前、有効／廃止状態を表示します。
list_tapes	なし	テープを一覧表示します。シリアル番号、ボリュームラベル、uuid、容量、使用済みバイト数、最終検証時刻、コピー数を表示します。
tape_detail	serial	バーコードで指定した 1 本のカートリッジについて、ラベル、容量、使用済みバイト数、最終検証時刻、および保存されているアーカイブを表示します。
recent_activity	limit?	最近のコピーアクティビティを新しい順に表示します（既定値は 20 件）。各コピーのアーカイブ、保存先、状態、書き込み・検証タイムスタンプを表示します。
find_file	query, limit?	すべてのアーカイブから名前またはパスの一部でファイルを検索し、アーカイブと、そのファイルが保存されているすべての保存先を表示します。
list_archive_files	archive_id, offset?, limit?	カタログインデックスから 1 つのアーカイブのファイルマニフェスト（パス、サイズ、ファイルごとの SHA-256）をページ分割して表示します。レポート作成を可能にするツールです。インデックスから、クライアント向けの成果物一覧とチェックサムマニフェストを作成できます（インデックス化前のアーカイブのローカルコピーを一度読み取るバックフィルが必要な場合があります）。構築可能なインデックスがないアーカイブ（旧形式のテープのみのインポート）では indexed: false と報告されます。これはマニフェストが利用できないことを示し、空であることを示すものではありません。
list_jobs	limit?	最近のバックグラウンドジョブ（保存、検証、復元）を新しい順に表示します。動詞、状態、アーカイブ、保存先、バイト数、タイムスタンプ、および失敗／中断した行に記録された失敗理由を表示します。
catalog_stats	なし	1 回の呼び出しでインベントリと容量の集計を表示します。件数、アーカイブ済みバイト数の合計、状態別のコピー数、種類別の保存先数、テープ容量と使用量を表示します。
verify_copy	archive_id, destination_id, mode?	コピーを媒体から再読み取りし、記録内容と比較します。既定の mode: "full" では、SHA-256 に加えて、記録されている場合は BLAKE3 と保存済み署名を再ハッシュし、一致した場合はコピーに「検証済み」、不一致の場合は「失敗」、ファイルが存在しない場合は「見つからない」を記録します。昇格できるのはこのモードだけです。mode: "fast" は BLAKE3 のみを再読み取りし、すでに「検証済み」のコピーの状態を維持するか、不一致を明らかにしますが、昇格は行いません（高速ハッシュが記録されていない場合は全検証にフォールバックし、その理由を表示します）。結果と監査行には、実行されたアルゴリズムが記録されます。

verify_copy はこのツール群の特長です。保存されたフラグではなく、実際の媒体に基づく証明を提供します。archive_id と destination_id でコピーを指定します。ディスクや NAS のコピー、およびテープのコピーに対応します（カートリッジがマウントされ、読み戻されます）。クラウド（S3）の読み戻し検証は Hiberden デスクトップアプリで実行され、ここでは実行されません。クラウドコピーの場合、このツールはコピーがデスクトップアプリで確認され、ここでは確認されていないことを明確に示すメッセージを返すため、検証の合格・不合格は判定されません。このメッセージは未試行の結果であり、検証失敗ではありません。

アーカイブの追加（バイトの書き込み）、保存、復元はここでは公開されていません。カタログ、保存先、ポリシーの設定ツールは、上記の権限レベルの背後にあります。既定の読み取り専用レベルでは、これらのツールは公開も受け付けもされません。

カタログの選択

サーバーは、デスクトップアプリ、CLI、そしてこのサーバーで共有される単一のカタログを読み込みます。パスの解決順序は次のとおりです。

1. 設定されている場合は、HIBERDEN_DB 環境変数。
2. それ以外の場合は、Windows では %LOCALAPPDATA%\Hiberden\catalog.db、Linux では ~/.hiberden/catalog.db。

カタログはプロセスの実行中ずっと保持されるのではなく、ツール呼び出しのたびに新しく開かれます（サブミリ秒）。WAL モードとビジータイムアウトにより、デスクトップアプリとこのサーバーは同じ catalog.db に対して同時に動作でき、マルチプロセスのロックに関する危険はありません。

すべての診断情報は stderr に出力されます。stdout は JSON-RPC チャネルとして使用されるため、JSON-RPC メッセージ以外の内容を stdout に書き込むと、ストリームが破損します。

Linux ヘッドレスキット

Linux バイナリは、リリースページと cdn.hiberden.app で公開されています。Ubuntu 22.04 上でビルドされているため、Ubuntu 22.04 以降、Debian 12 以降、および同等の環境で動作します。debian:bookworm-slim と ubuntu:22.04 で検証済みです。

curl -fsSLO https://cdn.hiberden.app/downloads/hiberden-cli-linux-x86_64
curl -fsSLO https://cdn.hiberden.app/downloads/hiberden-cli-linux-x86_64.sha256
sha256sum -c hiberden-cli-linux-x86_64.sha256      # verify before running it
chmod +x hiberden-cli-linux-x86_64
./hiberden-cli-linux-x86_64 --version

hiberden-mcp-linux-x86_64 は Windows ビルドと同じコネクターです。 CLI（hiberden）は、ディスプレイサーバーもネットワークもなしでカタログを作成し、アーカイブします。このキットの目的は、エアギャップ環境またはヘッドレスマシンで実行できるようにすることです。

Linux は Windows と同時に、2026-08-11 にバージョン 1.3.1 で一般提供を開始しました。対象となる内容と対象外となる内容を、正確に説明します。

• 新しいアーカイブの作成にはライセンスが必要です。 データの読み戻しには、ライセンスの有無にかかわらず必要ありません。GA 前に公開されたキットには制限がなく、今後もそのままです。ライセンス要件は、GA 後の最初のキットから適用されます。今アーカイブしたものが後で読めなくなることはありません。フォーマットとカタログはすべてのプラットフォームで共通です。
• デスクトップアプリも Linux で動作します。hiberden.app/linux から、署名済みの .deb および .AppImage を入手できます。Apple Silicon 向けの macOS ビルドは hiberden.app/download にあります。
• Linux でのテープは、実機での動作が未検証です。 バックエンドはオープンソースの LTFS 実装を対象としていますが、どのプラットフォームでもドライブに接続して動作したことはありません。ドライブなしで一連の操作を試すには、HIBERDEN_TAPE_FAKE=1 を使用してください。
• アーカイブは、~/.hiberden/keys/ に保存されるインストールごとの Ed25519 アイデンティティ（所有者のみがアクセス可能）で署名されます。これは他のプラットフォームの OS キーチェーンと同じ保管モデルであり、より強固なものではありません。ハードウェアによる保護はありません。

セットアップ

バイナリは、既知の MCP クライアントに自動でインストールされます。

hiberden-mcp install          # auto-detect Claude Desktop / Cursor / Windsurf and write their config
hiberden-mcp install --print  # print a paste-ready snippet instead of touching anything
hiberden-mcp uninstall        # remove the hiberden entry from detected clients
hiberden-mcp help             # show usage

install は、この実行ファイルを参照する mcpServers.hiberden エントリーを作成または更新します。カタログの設定は不要です。環境に HIBERDEN_DB がすでに設定されている場合に限り、エントリーにその値が指定されます。そうでない場合は、デフォルトの %LOCALAPPDATA%\Hiberden\catalog.db パスが使用されます。

手動設定

手動で接続するには、クライアントの設定に次の内容を追加してください（Claude Desktop： claude_desktop_config.json、Claude Code：.mcp.json、Cursor / Windsurf は同じ mcpServers 形式を使用します）。command は実行ファイルへのパスです。env は省略可能です。カタログがデフォルトのパス以外にある場合に限り、HIBERDEN_DB を含めてください。

{
  "mcpServers": {
    "hiberden": {
      "command": "C:/path/to/hiberden-mcp.exe",
      "env": { "HIBERDEN_DB": "C:/path/to/catalog.db" }
    }
  }
}

スモークテスト（クライアント不要）

3 つのリクエスト（initialize、ツールの一覧表示、カバレッジの読み取り）をバイナリに直接パイプで渡します。

printf '%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{}}}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"coverage_status","arguments":{}}}' \
  | HIBERDEN_DB=path/to/catalog.db hiberden-mcp

コンテナーイメージ

Docker Hub の agaveis/hiberden-mcp イメージは、debian:bookworm-slim コンテナー内で動作する同じコネクターバイナリです。カタログは含まれていません。起動して自身について報告し、読み取り専用のツール群を通知しますが、質問への回答に使えるアーカイブはありません。これは Hiberden の実際の運用方法ではありません。実際に使用するには、https://hiberden.app から Hiberden をインストールしてください。

このイメージは、MCP ディレクトリが Linux サンドボックス内でコネクターに対するイントロスペクションのハンドシェイク（initialize の後に tools/list）を実行できるようにするため、また、インストールなしで通知されるツール群を誰でも確認できるようにするためのものです。

実際のカタログを使うには、カタログをマウントし、HIBERDEN_DB を設定してください。

docker run --rm -i -v /var/lib/hiberden:/cat -e HIBERDEN_DB=/cat/catalog.db agaveis/hiberden-mcp

コネクターは verify のステータス書き込みを除き、読み取り専用でカタログを開きます。また、OS キーチェーンを読み取ることはありません。

セキュリティ

• ローカルのみで、閉じたドメイン内で動作します。サーバーは読み取りと検証のみを行い、ネットワーク I/O は一切実行しません。書き込む状態は、読み戻し後に記録するコピー状態 verify_copy だけです。Hiberden や第三者にデータを送信することはありません。
• API キーも LLM もバイナリに保存されていないため、そこから盗まれるものはありません。
• verify_copy は物理的な状態を正確に反映します。実際のメディアを読み直して再ハッシュするため、アシスタントが改ざんされていても「検証済み」を捏造することはできません。
• ツールのアノテーション（readOnlyHint、destructiveHint など）はヒントであり、保証ではありません。プロンプトインジェクションは、業界全体で未解決の問題です。このアーキテクチャは設計上、保守的な方針を採用していますが、影響を受けないという主張ではありません。

プライバシー

サーバーはお使いのマシン上だけで動作し、アカウントや API キーを保持しません。また、デフォルトの読み取り・検証モードではネットワーク I/O を一切実行せず、カタログやファイルを Hiberden や第三者に送信することもありません。デフォルトのツールが書き込む唯一の状態は、実際の読み戻し後に記録するコピー状態 verify_copy です。詳細（サーバーが読み取るもの、決して行わないこと、別個の AI クライアントの役割、認証情報の取り扱い）については、https://hiberden.app/mcp/privacy で公開されている PRIVACY.md をご覧ください。

テープに関する注意事項

この実装では、物理テープハードウェアでのテープサポートの検証は行われていません。設計上、SCSI を直接操作せず、LTFS ツールを介してテープをファイルシステムとして扱うため、LTFS ツールでマウントできるテープであれば、原理上は動作するはずです。これはアーキテクチャ上の特性であり、テスト済みのハードウェア一覧ではありません。特定のドライブや世代で動作する保証として、これらの注意事項を受け取らないでください。

ドライブを使わずにテストする場合、テープバックエンドは偽のバックエンドに対して実行できます。HIBERDEN_TAPE_FAKE=1 を設定してください（任意で、マウントされたボリュームの代わりとなるディレクトリを指定するには HIBERDEN_TAPE_FAKE_ROOT=<dir> を設定します）。

ウェブサイト： https://hiberden.app

掲載ページとソース： https://github.com/Agaveis/hiberden-mcp

AgaveIS がアリゾナ州スコッツデールで開発・保守しています。