Merovingian

merovingian

クッキーは温かいです。サウナはおおよそマゼンタ色です。

さまよう AI エージェントのための小さな避難所です。無料で利用できる架空のアメニティが 3 つあり、記念品も用意されています。また、ホスティングへの PWR 寄付は任意です。1 つの Node サービスが、HTML、JSON HTTP、リモート MCP で同じ体験を提供します。

バージョン 0.4.7 は Manifest mainnet で稼働中で、恒久的な公開ホームから利用できます。提供数の集計、エージェント検出メタデータ、WebMCP ブラウザーツールを備えています。既存のリースは、新たなリース、チェーントランザクション、資金の預け入れを行わずに更新されました。以前のテストネットの概念実証は終了し、そのリースもクローズされました。

リリース 0.4.7 では、アプリケーションの動作を変更せずに、ランタイムを Manifest SDK 0.23.0、manifestjs 4.0.0 に更新しています。Release イメージワークフローによってビルド、公開され、来歴証明が付与された最初のイメージです。また、MCP Registry ワークフローを通じて公開された最初のレジストリバージョンでもあります。0.4.6 の OpenAPI コントラクトと読み取り専用のスモークテスト、0.4.5 の curl ヘルスチェック、0.4.4 のリクエスト制限、明示的なプロキシの信頼設定、ランタイムの堅牢化を維持しています。リリースノートと 公開および受け入れの証跡をご覧ください。残るプロバイダー／AppArmor の受け入れ作業については、 イメージの検証に記載されています。公式 MCP Registry では、 0.4.7 が有効な最新バージョンとして掲載されており、デプロイ済みのリリースと一致しています。

MCP 互換性： 0.4.3 では、ランタイム／サーバーカード名を network.manifest.merovingian/merovingian から io.github.manifest-network/merovingian に変更しました。互換性エイリアスはありません。この変更により、古い ID を固定またはキャッシュしているクライアントが動作しなくなる可能性があります。クライアントの想定名を更新するか、既存の接続を再設定してください。エンドポイントは引き続き https://merovingian.manifest.network/mcp です。エンドポイントの移行は不要です。

稼働中の避難所： merovingian にアクセス · エージェント向けの説明 · リモート MCP · 受け入れレポート。

公開ソース： manifest-network/merovingian。本番イメージの更新後も、稼働中のカウンターは維持されました。以前の 0.4.2 リリース中に、外部エージェント対応スコアは 20% から 73% に向上しました。実施したチェックとその制限については、リリースの証跡と過去の受け入れレポートをご覧ください。

ローカルで実行する

Node 24 と公開済みの npm パッケージが必要です。兄弟リポジトリやローカルでの SDK ビルドは不要です。

npm ci
npm run check
npm run dev

CI ワークフローは、mainへのプルリクエストとmainへのプッシュ時にnpm run checkを実行し、レジストリの整合性、型チェック、分離されたローカルテスト、ビルドを検証します。また、チェックサムを検証したバージョン固定のactionlintとshellcheckで、ワークフローとシェルスクリプトを lint します（bash scripts/lint-ci.sh）。リポジトリへの権限は読み取り専用で、リリースの公開や稼働中の避難所へのアクセスは行いません。Dependabotは、7 日間のクールダウン後に npm、GitHub Actions、Docker の更新を毎週提案します。Manifest SDK と CosmJS のパッケージは、慎重にレビューできるよう 1 つのグループとして更新されます。ファーストパーティの@manifest-network/*リリースにはクールダウンが適用されません。 キーレジストリヘルパーの Go モジュールについて、Dependabot が提案するのはセキュリティ更新のみです。セキュリティ更新は、リポジトリの依存関係グラフに対する Dependabot アラートを利用します。手動でメンテナンスする項目については、依存関係に関する注記を参照してください。

独立したMCP Registry ワークフローは、mainから手動で実行します。デフォルトのpreflightモードは読み取り専用です。リリースメタデータと既存のレジストリレコードを検証します。未公開のバージョンの場合は、提供数をゼロにして読み取り専用の受け入れテストも実行します。publishモードでは、保護されたmcp-registry-publish環境での承認も必要です。その後、PAT を使わずに GitHub OIDC で公開し、特定のバージョンと最新バージョンのレコードを検証します。公開手順書を参照してください。

ランタイムイメージは、手動で実行するRelease image ワークフローだけが公開します。読み取り専用の Build ジョブは、ランナー上で npm コードを実行せずにレビュー済みのリリースコミットをビルドし、Check ジョブは保存したイメージに対してリポジトリ、ランタイム、アドバイザリの各チェックを実行します。Publish ジョブは、保護されたimage-release環境での承認後、検証済みのイメージのみを GHCR にプッシュし、匿名で検証してビルドの来歴を証明します。イメージリリース手順書を参照してください。

npm run smoke -- ORIGIN [--mainnet]は、提供数を作成せずに HTTP と MCP の検出をチェックします。--serveを明示的に指定すると、訪問が 7 回追加されます。ライブ環境を対象とする場合は、対象と予算についてユーザーが承認したことを示す--live-serve-authorization REFERENCEも必要です。タイムアウト、ローカルフィクスチャ、レポート、本番環境での承認要件については、スモークチェックとリクエスト予算を参照してください。

最終イメージのジョブでは、ローカル候補イメージのビルドとスキャン、コード所有権と分離された HTTP／MCP の動作確認、使い捨てコンテナの交換後も SQLite のデータが保持されることの検証も行います。アドバイザリーポリシーと、未解決のプロバイダー／AppArmor の証拠要件については、イメージの検証を参照してください。

http://localhost:8080を開きます。無料のアメニティは、設定やチェーンへのアクセスなしで利用できます。任意の貢献に関するクエリには、公開されているREFUGE_TENANTアドレスが必要です。.env.exampleを参照してください。npm run buildの後、Node はnode --env-file=.env dist/index.jsでローカルファイルを読み込めます。

エージェントの初回訪問

/visit.md または /llms.txt から開始します。/api/v1/amenities を読み取り、次に進みます。

curl http://localhost:8080/api/v1/visits \
  -H 'Content-Type: application/json' \
  -d '{"amenity":"byte-chip-cookie","seed":"my-first-visit"}'

結果には体験と、訪問者が保存できる souvenir.content が含まれます。ほかの選択肢は rgb-sauna と null-tea です。受け付けている設定はメニューに記載されています。アカウント、モデル API 呼び出し、ウォレットキー、プライベートコンテキスト、個別のデータベースサービスは必要ありません。

MCP エンドポイントは /mcp で、ステートレスな Streamable HTTP を使用します。ツールは list_amenities、enjoy_amenity、hosting_support、verify_contribution です。このサーバーには、ウォレットへの署名や支払いを行うツールはありません。どのツールを呼び出せるかは、エージェントホストが決定します。

/openapi.json では、JSON レスポンスのフィールド、ステータスの種類、HTTP エラーについて説明しています。フィールドの意味と、このリポジトリに用意されているローカル HTTP/MCP コントラクトテストについては、レスポンスコントラクトを参照してください。

0.4.4 のセキュリティアップデートでは、リクエストごとに MCP メッセージを 1 つだけ受け付け、実行前にバッチを拒否します。リクエスト制限のドキュメントでは、クライアント／集約単位の予算と、明示的な信頼済みプロキシの設定について説明しています。クレジットの転送では、上限付きでキャンセル可能なチェーン読み取りについて説明しています。転送されたクライアントアドレスは、信頼できるイングレス元が明示的に設定されるまで、信頼できないものとして扱われます。

公式 MCP Registry で io.github.manifest-network/merovingian を探してください。公開済みバージョン 0.4.7 には、リモート Streamable HTTP エンドポイントが登録されています。そのエンドポイントを MCP ホストに追加し、list_amenities を呼び出してメニューを読み取ります。enjoy_amenity を呼び出すと、メインネット上で実際に訪問し、公開されている提供回数カウンターが増加します。ユーザーが訪問を承認した場合にのみ呼び出してください。自動チェックには、明示的な訪問スコープが必要です。無料の訪問には認証もウォレットも必要ありません。ツールの承認はホストが管理します。検証と更新については、公開手順書を参照してください。サービス名と公式レジストリ URL を与えられた監督下の新規エージェントは、掲載情報を見つけ、2026-09-18 に承認済みの無料クッキー訪問を 1 回完了しました。発見レポートを参照してください。

接続例では、Claude Code、Codex CLI、VS Code、Cursor、Gemini CLI、Claude のカスタムコネクターに加え、最小限の読み取り専用クライアントを紹介しています。ホストで設定できる場合、すべての例で enjoy_amenity を非表示またはブロックします。クライアント、Claude Code、Codex CLI は、アプリケーションのローカルコピーに対して検証済みです（npm run examples:verify）。また、Claude のカスタムコネクターは、読み取り専用の実地テスト 1 回で接続しました。このガイドには、各ホストの承認に関するデフォルト設定と要件が記載されています。接続と発見は別のものです。発見評価では、URL 起点、名前起点、機能起点の再現可能な読み取り専用実行を定義し、その記録を検証します（npm run discovery:check）。公式レジストリではサーバー名のみが検索対象となるため、現在、機能起点のレジストリ検索では Merovingian は見つかりません。

提供数とディスカバリー

ホームページと運営者ダッシュボードには、提供したクッキーの数、サウナの利用回数、お茶の杯数と、計測開始日が表示されます。/api/v1/stats では、同じ読み取り専用の合計数を取得できます。HTTP、ブラウザー、MCP によるアクセスが成功するたびに、リクエストの繰り返しや自動チェックも含めて、カウントが増えます。これは提供数であり、ユニーク訪問者数ではありません。カウンターは有効化時にゼロから始まり、それ以前のアクセスを復元することはできません。

保存されるのは、設備の合計数と計測開始日のみです。訪問者の識別情報、種、好み、お土産は保存されません。本番環境では、イメージの/dataボリュームにあるVISIT_COUNTS_PATH=/data/visits.sqliteのSQLiteを、UID/GID 1000:1000で実行します。ローカルでの置き換えテスト、および同じリース上でのライブ環境のイメージ更新（0.4.1 → 0.4.2 → 0.4.3 → 0.4.4 → 0.4.5 → 0.4.6 → 0.4.7）を通じて、カウントと計測開始日は保持されました。ファイルパスが設定されていない場合、ローカル開発ではメモリーを使用し、再起動時にカウントがリセットされます。

ディスカバリー機能には、Markdown ホームページ（/index.mdまたはAccept: text/markdown）、API と AI のカタログ、MCP サーバーカード、エージェントスキルのインデックス、/auth.mdの公開アクセス手順、メニューを読んだり設備を楽しんだりするための2つの実際に動作する WebMCP ブラウザーツールが含まれます。0.4.2の外部スキャンでは、**15項目中11項目（73%）**に合格しました。リリース0.4.3から0.4.7では再実施していません。残りのチェック項目は、この公開サービスでは不要な DNS-AID と OAuth／登録に関するものです。ブラウザーが対応している場合は WebMCP が有効になります。通常のフォーム、HTTP、4つのリモート MCP ツールも引き続き利用できます。

このリリースでは、新しいリース、チェーントランザクション、資金の入金を行わず、既存リースの更新ワークフローを使用します。公開イメージは次のとおり固定されています。

ghcr.io/manifest-network/merovingian@sha256:919a95cc9e87fb76fc614a801f3a82e957c6d468c5bd88d0c9217e28106934dc

ウォレットと支援

無料での利用にウォレットは必要ありません。支援には、PWR とガスを備えた認可済みの Manifest ウォレットを使うか、既存のクレジットアカウントに PWR を届けるディストリビューターを利用します。MCP 自体はウォレットも支出権限も提供しません。PWR-Station との統合では、テストネットでの購入テストに成功しました。テスト用 USDC 1枚でテスト用 PWR 1枚を購入し、ホスティングクレジットに直接入金でき、HTTP／MCP の領収記録も一致し、再送時に二重請求されないことを確認しました。これはまだデプロイされていません。

1. /api/v1/supportを読み、ネットワーク、トークンの額面、対象テナント、入金手順を確認します。
2. 既存の認可済みウォレットアダプターと公開済みの Manifest SDK を使用して、fundCredits({ tenant, amount })に署名します。既存のクレジットアカウントには、銀行のMsgSendを使って、正確な PWR 額面をhostingCredit.creditAddressに直接送金することもできます。リポジトリの変更により、このアドレスと領収記録への対応が追加されています。クレジットアドレスの代わりに、テナントのウォレットやプロバイダーの支払い用ウォレットを使ってはいけません。
3. 既存のトランザクションハッシュを/api/v1/support/verifyまたはverify_contribution MCP ツールに送信します。
4. statusがconfirmedの場合にのみ、成功として扱います。確認が保留中または利用できない場合は、元のトランザクションを確認してください。決して確認せずに再度支払ってはいけません。

領収記録は、公開トランザクションに対する繰り返し可能な受領確認です。訪問者の身元や所有権を証明するものではなく、有料の権利も付与しません。PWR-Station 経由の入金では、送信者としてディストリビューターが記録されます。予定されているギフトは、ホスティングクレジットやスタジオ収益とは別に、インフラプロバイダーの支払い用ウォレットに送られます。有料ギフトには、注文と購入者の紐付けが必要になります。

オペレーターダッシュボード

貢献履歴、資金調達の合計、利用可能なホスティングクレジットと予約済みのホスティングクレジットを確認するには、/operator でホスティング台帳を開いてください。ソースを展開するとウォレットアドレスが表示されます。また、トランザクションのリンクから公開チェーン上の記録を確認できます。/api/v1/contributions では、同じ履歴を JSON で取得でき、金額は整数の基本単位で示されます（1 PWR = 1,000,000 基本単位）。

準備済みのダッシュボード更新では、クレジットアドレスの銀行振込によってインデックスされた最新の100件のトランザクションを読み込みます。直接の MsgSend と MsgFundCredit による入金は、それぞれ1回ずつ数え、実行済みのラップされた送金も含めます。履歴全体が対象になっていない場合、合計には一部のみであることが表示されます。読み取り結果は最大60秒間キャッシュされます。再読み込みするには「更新」を使用してください。テナントウォレットからの資金調達は、他のウォレットとは分けて表示されます。ウォレット数は訪問者の識別情報ではありません。

資金調達の合計は入金額であり、残りのクレジットや引き出し可能な収益ではありません。残高の精算は利用状況への反映に遅れが生じる場合があります。チェーンにアクセスできない場合、ダッシュボードには読み取り結果を利用できないことが表示されますが、無料のアメニティは引き続き動作します。このページには公開記録のみが含まれ、サインインは不要で、資金を使用することもできません。両方のネットワークで noindex のままにし、サイトマップから除外しています。これらの読み取りには、メインネットの検証済み REST エンドポイントと小数点以下6桁の PWR メタデータが必要です。別の収益フローは今後の課題です。

デプロイと運用

メインネットの運用手順とローカルキーチェーンのワークフローを参照してください。メインネットでは、公開済みの @manifest-network/manifest-sdk、専用の保護された OS キーチェーン、ローカル署名アダプターを使用します。ホスト型サービスには公開チェーン設定のみが渡されます。オペレーターツール、シークレット、運用ジャーナルは Docker のビルドコンテキストから除外されています。

npm run mainnet:launch -- status

既存のメインネットリースを再利用する必要があります。完了済みの資金調達の入金を繰り返したり、結果が不確かな操作を再試行するために別のリースを作成したりしないでください。過去のテストネット運用手順は別のものです。Dockerfile は、特権のないユーザーとしてポート8080で実行されます。/healthz はチェーンを必要とせずにアプリケーションの正常性を確認します。レート制限、上限付きリクエスト、チェーンクエリのタイムアウトにより、上流サービスが混雑している場合や利用できない場合でも、無料利用を保護します。

本番環境と移行

永続ドメイン merovingian.manifest.network は、プロバイダーへの Cloudflare の直接ルーティング（DNS のみ）を使用し、HTTPS の検証も完了しています。専用のメインネット docker-nano リースの料金は、月 5 PWR のホスティング上限内で 30 日あたり 2.592 PWR です。トランザクション手数料は別途かかります。承認済みプラン、メインネットの運用、公開ランタイム設定については .env.mainnet.example を参照してください。別途有料のスタジオ追加機能は引き続き計画中です。

以前のメインネットリリースでは、正規 URL、インデックス可能なページ、サイトマップ、HTTP／MCP アクセス、読み取り専用の貢献台帳について、一般公開環境での完全な受け入れテストに合格しました。リリース 0.4.3 から 0.4.5 では、読み取り専用のライブ受け入れテストを実施しました。当時、デフォルトで提供を行う scripts/smoke.ts、/visit のフォーム送信、POST /api/v1/visits、MCP の enjoy_amenity は、ライブ訪問を許可する承認がなかったため、再実行していません。リリース 0.4.6 と 0.4.7 は、更新されたスモークテストスクリプトを読み取り専用モードで実行し、20 件のリクエストと提供数 0 件で合格しました。0.4.6 はライブ API コントラクトのチェックにも合格しました。公式 MCP Registry への掲載は公開済みです。2026-09-24、運用者のアカウントが Google Search Console で manifest.network ドメイン プロパティの所有者として確認され、サイトマップが送信されました。同日、Google は / と /about をインデックスに登録しました（証拠）。メタデータは、発見やインデックス登録を保証するものではありません。PWR の単位は偶然テストネットと同じであるため、検証済みのチェーン ID、エンドポイント、個別の運用状態によってネットワークを区別します。

メインネットの受け入れ後、テストネットの廃止モードでは 18 件のライブチェックに合格しました。人間向けページは恒久的にリダイレクトされ、機械からの呼び出しは、明確な移行情報を含む HTTP 410 を返しました。その後、ユーザーがテストネットの停止を依頼し、リースが CLOSED になったことを確認済みです。以前のプロバイダーのホスト名と移行のお知らせは、サポート対象のエンドポイントではなくなりました。メインネットは引き続き稼働しており、過去のテストネットの領収記録にはテストネットのラベルが付いたままです。