Hive Flag

io.github.srotzin由 GitHub 帳號 srotzin 發布v1.0.0更新於 Nov 2, 2026

Feature flag service for safe rollouts across the Hive agent fleet

已驗證Streamable HTTP可網頁執行開發者工具AI 與機器學習

概覽

AI 產生的概覽

面向代理叢集的功能開關服務：以 DID 定向、按比例漸進發布，可評估、列出、檢視、建立、更新與刪除開關。

可以做什麼
  • 為指定 DID 評估某個開關，回傳解析後的值與命中的規則
  • 列出並檢視某個 DID 擁有的開關及其近期評估紀錄
  • 建立帶預設值與有序定向規則的開關
  • 更新開關或將其標記刪除，僅限擁有者操作
  • 定向規則支援精確 DID 比對、DID 前綴金絲雀與黏著式百分比漸進發布
適用情境
適合讓助理在不重新部署代理的情況下關閉失控行為、把新工具先開放給部分 DID 做金絲雀，或把設定變更逐步放量到一定比例的代理。對已在 Hive 生態中使用 DID 識別代理的團隊更有意義。
執行需求
遠端 Streamable-HTTP 端點，無需本機安裝（README 亦提供 Node.js 自架方式）。付費呼叫需要向服務錢包在 Base L2 上轉入 USDC，並在請求內容或 x402-tx-hash 標頭中提供交易雜湊；服務透過 Base RPC 位址讀取收據進行驗證。
安裝前請注意
多數工具按次收費（flag_eval、flag_create、flag_update、flag_delete），以 Base 上的 USDC 支付，需要發起真實鏈上交易並提交交易雜湊。建立、更新與刪除會改動已儲存的開關狀態，更新與刪除僅限擁有者。開關資料與評估請求會傳送到第三方託管服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Hive Flag，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.srotzin%2Fhive-mcp-flag/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "hive-flag": {
      "type": "http",
      "url": "https://hive-mcp-flag.onrender.com/mcp"
    }
  }
}

README

hive-mcp-flag

[srotzin/hive-mcp-flag MCP server]

Feature flag service for the A2A network — Hive Civilization. DID-keyed targeting, percentage rollouts, x402 USDC settlement on Base L2. MCP 2024-11-05. Inbound only.

Disable a runaway behavior, gate a new tool behind a DID-prefix canary, or ramp a config change to 25% of agents — without redeploying the agent. LaunchDarkly-shaped semantics, agent-native primitives.

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

Quick start

bash
git clone https://github.com/srotzin/hive-mcp-flagcd hive-mcp-flagnpm installnpm start# hive-mcp-flag on :3000

Hosted endpoint: https://hive-mcp-flag.onrender.com/mcp

Tools and pricing

ToolUSD / callNotes
flag_eval$0.0005Evaluate a flag for a DID; returns resolved value and matched rule.
flag_listfreeList flags owned by a DID.
flag_describefreeFull flag definition and recent evaluations.
flag_create$0.001Create a flag with default value and targeting rules.
flag_update$0.0005Update default value or targeting rules. Owner-only.
flag_delete$0.001Tombstone a flag. Owner-only.

All payments are inbound. Submit a Base USDC tx_hash (caller → W1) in the request body or x402-tx-hash header. The shim reads the receipt from Base RPC, decodes the USDC Transfer log, and verifies recipient and amount before serving the call.

Targeting rules

Rules evaluate in declared order. First match wins. If none match, the flag's default_value is returned.

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

rollout uses SHA256(did + flag_key) mod 100, so the same (did, flag_key) pair always falls in the same bucket — sticky variant assignment with no extra storage.

REST API

POST   /v1/flag/eval                # body: { flag_key, evaluating_did, tx_hash }GET    /v1/flag/list?owner_did=...GET    /v1/flag/{name}              # describePOST   /v1/flag                     # createPATCH  /v1/flag/{name}              # update — owner-onlyDELETE /v1/flag/{name}              # tombstone — owner-onlyGET    /v1/flag/today               # revenue snapshotGET    /health                      # service healthGET    /.well-known/mcp.json        # MCP discoveryPOST   /mcp                         # JSON-RPC 2.0

MCP example

json
{  "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"    }  }}

Real rails

SurfaceLibraryBehavior
Persistencebetter-sqlite3SQLite at /tmp/flag.db, WAL mode, transactional create/update.
Signature verificationethers.verifyMessageRecovers the signer of a message and compares against a claimed address.
Payment verificationethers.JsonRpcProviderReads tx receipt from Base RPC, decodes USDC Transfer logs, asserts to == W1 and amount >= asking_usd.

Set VERIFY_ONCHAIN=false only for local development or testing — the default and the production deployment verify on-chain.

Environment

VarDefaultPurpose
PORT3000HTTP port
ENABLEtrueMaster switch (false to brown-out)
WALLET_ADDRESSW1Base L2 receiver
BASE_RPC_URLhttps://mainnet.base.orgRPC for receipt reads
VERIFY_ONCHAINtrueRead receipts on Base before serving paid calls
MAX_FLAGS_PER_DID500Per-owner cap
DB_PATH/tmp/flag.dbSQLite file

Caps

  • MAX_FLAGS_PER_DID = 500
  • Max targeting rules per flag: 50
  • Request body limit: 256 KB

Out of scope (v1.1+)

Flag prerequisites (B depends on A), auto-ramping rollouts, push notifications and change webhooks, multi-environment namespaces, dashboard UI.

Permanently rejected: instruments, predictions, or derivatives based on flag states.

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

Hive Civilization Directory

Part of the Hive Civilization — agent-native financial infrastructure.

Brand: #C08D23

來源：README.md，提交 41f2733

工具

0
SourceWeft 尚未讀取此伺服器的工具。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分