Hive Flag

hive-mcp-flag

A2A ネットワーク「Hive Civilization」向けのフィーチャーフラグサービスです。 DID に基づくターゲティング、パーセンテージ単位の段階的ロールアウト、Base L2 上での x402 USDC 決済に対応しています。MCP 2024-11-05。受信のみです。

エージェントを再デプロイすることなく、制御不能な動作を無効にしたり、DID プレフィックスのカナリアテストで新しいツールを制限したり、設定変更をエージェントの 25% に段階的に適用したりできます。LaunchDarkly に似たセマンティクスと、エージェントネイティブなプリミティブを備えています。

brand : Hive Civilization gold #C08D23 (Pantone 1245 C)
spec  : MCP 2024-11-05 / Streamable-HTTP / JSON-RPC 2.0
wallet: W1 MONROE 0x15184bf50b3d3f52b60434f8942b7d52f2eb436e (Base)

クイックスタート

git clone https://github.com/srotzin/hive-mcp-flag
cd hive-mcp-flag
npm install
npm start
# hive-mcp-flag on :3000

ホストされたエンドポイント：https://hive-mcp-flag.onrender.com/mcp

ツールと料金

ツール	USD / 呼び出し	備考
flag_eval	$0.0005	DID に対してフラグを評価し、解決された値と一致したルールを返します。
flag_list	無料	DID が所有するフラグを一覧表示します。
flag_describe	無料	フラグの完全な定義と最近の評価結果を表示します。
flag_create	$0.001	デフォルト値とターゲティングルールを指定してフラグを作成します。
flag_update	$0.0005	デフォルト値またはターゲティングルールを更新します。所有者のみ実行できます。
flag_delete	$0.001	フラグを論理削除します。所有者のみ実行できます。

すべての支払いは受信のみです。リクエスト本文または x402-tx-hash ヘッダーで Base の USDC tx_hash（呼び出し元 → W1）を送信してください。shim は Base RPC からレシートを読み取り、USDC Transfer ログをデコードしてから、呼び出しを処理する前に受取先と金額を検証します。

ターゲティングルール

ルールは宣言された順序で評価されます。最初に一致したルールが適用されます。一致するルールがない場合は、フラグの default_value が返されます。

[
  { "type": "did_match",  "dids": ["did:hive:0xabc"], "value": true },
  { "type": "did_prefix", "prefix": "did:hive:",      "value": true },
  { "type": "rollout",    "percent": 25,              "value": true }
]

rollout は SHA256(did + flag_key) mod 100 を使用するため、同じ (did, flag_key) の組み合わせは常に同じバケットに入ります。追加のストレージを必要とせず、バリアントの割り当てが固定されます。

REST API

POST   /v1/flag/eval                # body: { flag_key, evaluating_did, tx_hash }
GET    /v1/flag/list?owner_did=...
GET    /v1/flag/{name}              # describe
POST   /v1/flag                     # create
PATCH  /v1/flag/{name}              # update — owner-only
DELETE /v1/flag/{name}              # tombstone — owner-only
GET    /v1/flag/today               # revenue snapshot
GET    /health                      # service health
GET    /.well-known/mcp.json        # MCP discovery
POST   /mcp                         # JSON-RPC 2.0

MCP の例

{
  "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": {
    "name": "flag_eval",
    "arguments": {
      "flag_key": "new_routing_v2",
      "evaluating_did": "did:hive:0xabc",
      "tx_hash": "0xBASE_TX_PAYING_$0.0005_USDC_TO_W1"
    }
  }
}

実際の処理基盤

対象	ライブラリ	動作
永続化	better-sqlite3	/tmp/flag.db の SQLite を WAL モードで使用し、作成・更新をトランザクション処理します。
署名検証	ethers.verifyMessage	メッセージの署名者を復元し、申告されたアドレスと照合します。
支払い検証	ethers.JsonRpcProvider	Base RPC からトランザクションレシートを読み取り、USDC Transfer ログをデコードして、to == W1 および amount >= asking_usd を確認します。

VERIFY_ONCHAIN=false を設定するのは、ローカル開発またはテストの場合に限ってください。デフォルト設定と本番環境のデプロイでは、オンチェーン検証が行われます。

環境変数

変数	デフォルト値	目的
PORT	3000	HTTP ポート
ENABLE	true	マスタースイッチ（false にすると機能を一時停止します）
WALLET_ADDRESS	W1	Base L2 の受取先
BASE_RPC_URL	https://mainnet.base.org	レシートの読み取りに使う RPC
VERIFY_ONCHAIN	true	有料呼び出しを処理する前に Base 上のレシートを読み取ります
MAX_FLAGS_PER_DID	500	所有者ごとの上限
DB_PATH	/tmp/flag.db	SQLite ファイル

上限

• MAX_FLAGS_PER_DID = 500
• フラグあたりのターゲティングルールの最大数：50
• リクエスト本文の上限：256 KB

対象外（v1.1 以降）

フラグの前提条件（B は A に依存）、ロールアウトの自動段階的拡大、プッシュ通知と変更 Webhook、複数環境の名前空間、ダッシュボード UI。

恒久的に禁止：フラグの状態に基づく金融商品、予測、デリバティブ。

---

Hive Civilization · MIT · github.com/srotzin/hive-mcp-flag

Hive Civilization ディレクトリ

Hive Civilization の一部です。エージェントネイティブな金融インフラを提供します。

• エンドポイントディレクトリ： https://thehiveryiq.com
• ライブリーダーボード： https://hive-a2amev.onrender.com/leaderboard
• 収益ダッシュボード： https://hivemine-dashboard.onrender.com
• その他の MCP サーバー： https://github.com/srotzin?tab=repositories&q=hive-mcp

ブランドカラー：#C08D23