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 分