Albyhub Admin Mcp

io.github.llmops-pro由 GitHub 帳號 llmops-pro 發布v0.1.2更新於 Oct 27, 2026

Admin an Alby Hub Lightning node from an agent: info, balances, channels; safety-gated writes.

已驗證STDIO僅桌面金融開發者工具

概覽

AI 產生的概覽

讓 AI 助理管理 Alby Hub 閃電節點：讀取節點資訊、餘額、通道與子錢包，並提供受安全閘控的原始 API 請求。

可以做什麼
  • 讀取節點身分、網路與版本，以及鏈上與閃電的彙總餘額
  • 列出閃電通道的狀態與容量，並列出該 Hub 上已開通的 NWC 子錢包連線
  • 向任意 Alby Hub API 路徑送出通用 HTTP 請求，作為尚無型別化封裝的端點備援通道
  • 在啟用確認時，透過兩步確認調度器執行非 GET 請求
  • 對代理流量套用唯讀閘控、每分鐘滾動速率限制與僅追加的 JSON 稽核日誌
適用情境
適合執行 Alby Hub 節點、希望助理檢視全 Hub 餘額、通道狀態與子錢包清單，或探測不同 Hub 版本間路徑不一致的管理 API 的情境。它補足以錢包為範圍的 NWC 工具，涵蓋節點層級操作。
執行需求
需要 Node.js 20 或更新版本，透過 npx 在本機執行。需要一個可存取的 Alby Hub 實例，其基礎位址由 ALBYHUB_URL 指定（預設 Hub 介面取得的 API 權杖，由 ALBYHUB_TOKEN 指定。選用設定包括 ALBYHUB_READ_ONLY、ALBYHUB_REQUIRE_CONFIRM、ALBYHUB_MAX_REQUESTS_PER_MINUTE 與日誌路徑。
安裝前請注意
ALBYHUB_TOKEN 是完整權限 API 權杖，可能耗盡 Hub 的鏈上餘額；請縮小權限範圍，並在首次設定時設定 ALBYHUB_READ_ONLY=true。通用代理工具可送出會轉移資金或改變節點狀態的非 GET 請求，而確認閘控預設關閉。除非對遠端實例使用 HTTPS，請求會以 HTTP 送往你的 Hub，且每次嘗試都會寫入稽核日誌檔。

安裝

在 SourceWeft 中

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

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

albyhub-admin-mcp

Node-admin operations on your Alby Hub, exposed to an LLM agent. MCP server that wraps the Alby Hub HTTP API — read node info, balances, channels, NWC sub-wallets. Where NWC (nwc-mcp) ends (it's wallet-scoped), this server picks up: hub-wide on-chain balance, channel state, sub-wallet inventory.

v0.1 — defensive design. Alby Hub's admin API has evolved across versions and isn't publicly versioned in a stable way. So v0.1 ships one generic proxy tool that hits any path (the escape hatch) plus typed wrappers around a few well-established endpoints. If a typed wrapper's endpoint-guess fails against your Hub version, the proxy lets you discover the right path without re-shipping. v0.2 hardens the typed wrappers once smoke-tested against real Hubs.

The six tools

ToolMethodPathPurpose
albyhub_proxy_request**Generic HTTP proxy — escape hatch for any endpoint not yet wrapped.
albyhub_confirm_request**Two-step confirm dispatcher for proxy_request.
albyhub_get_node_infoGET/api/infoNode identity, network, version.
albyhub_get_balancesGET/api/balancesOn-chain + Lightning aggregate balances.
albyhub_list_appsGET/api/appsNWC connections (sub-wallets) provisioned on this hub.
albyhub_list_channelsGET/api/channelsLightning channels with status + capacities.

All typed wrappers are safe GETs. Non-GET behavior runs through albyhub_proxy_request, which is gated by ALBYHUB_READ_ONLY and ALBYHUB_REQUIRE_CONFIRM.

Requirements

  • Node 20+
  • A running Alby Hub instance (desktop app on http://localhost:8080, or self-hosted exposed somewhere)
  • An Alby Hub API token (Settings → Developer / Apps in the Hub UI)

Install

bash
npx -y albyhub-admin-mcp

Configure

bash
cp .env.example .env# edit .env: set ALBYHUB_URL (default http://localhost:8080) + ALBYHUB_TOKEN

Required

VarPurpose
ALBYHUB_URLBase URL of your Hub. Default http://localhost:8080. Use HTTPS if exposed remotely.
ALBYHUB_TOKENAPI access token. Full-scope tokens can drain the hub's on-chain balance — scope down or use ALBYHUB_READ_ONLY=true if your audience matters.

Optional safety knobs

VarDefaultPurpose
ALBYHUB_READ_ONLYfalseRefuse all non-GET requests via proxy_request. Strongly recommended for first-time setup.
ALBYHUB_REQUIRE_CONFIRMfalseTwo-step confirm for non-GET requests.
ALBYHUB_MAX_REQUESTS_PER_MINUTE30Rolling 60s rate limit.
ALBYHUB_LOG_PATH./albyhub-admin-mcp.logServer log.
ALBYHUB_AUDIT_PATH./albyhub-admin-mcp-audit.logAppend-only JSON-line audit log.

What if my Hub returns 404 on the typed wrappers?

The endpoint path probably differs in your Hub version. Use albyhub_proxy_request to probe — try /api/node, /info, /api/v1/info, etc. Once you find the right path, you can pin it in your usage (and ping the maintainer to fix the typed wrapper in v0.2).

agent: albyhub_proxy_request({ method: "GET", path: "/api/v1/info" })→ { status: 200, body: { ... } }   // found it

Safety model

The proxy tool's pipeline:

  1. ALBYHUB_READ_ONLY gate — non-GET requests blocked outright.
  2. Rate limit — rolling 60s window on the requests bucket.
  3. ALBYHUB_REQUIRE_CONFIRM gate — non-GET requests return a token; albyhub_confirm_request executes.
  4. HTTP request — Bearer auth, 15s timeout (override via timeout_ms).
  5. Audit log — every attempt (ok / blocked / error) as one structured JSON line.

GET-only convenience wrappers skip steps 1 + 3 (they're safe by construction) but still go through rate limit + audit.

Companion servers

  • nwc-mcp — wallet ops via NIP-47. Use this for per-sub-wallet spend; use albyhub-admin-mcp for hub-wide / node-level operations.
  • nostr-ops-mcp — NOSTR identity + publishing.
  • marketplace-mcp — NIP-15 marketplace storefront.

License

MIT — see LICENSE.

Contact / Issues

Built by LLMOps.Pro.

來源：README.md，提交 34ae5d7

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.2最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

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

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

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

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