English Français العربية

io.github.llmops-pro/albyhub-admin-mcp

السجل الرسمي الذكاء الاصطناعي والوكلاء

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package albyhub-admin-mcp
Claude Code 
claude mcp add albyhub-admin-mcp -e 'ALBYHUB_URL=<ALBYHUB_URL>' -e 'ALBYHUB_TOKEN=<your albyhub_token>' -e 'ALBYHUB_READ_ONLY=<ALBYHUB_READ_ONLY>' -- npx -y albyhub-admin-mcp@0.1.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "albyhub-admin-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "albyhub-admin-mcp@0.1.2"
            ],
            "env": {
                "ALBYHUB_URL": "<ALBYHUB_URL>",
                "ALBYHUB_TOKEN": "<your albyhub_token>",
                "ALBYHUB_READ_ONLY": "<ALBYHUB_READ_ONLY>"
            }
        }
    }
}

متغيرات البيئة

  • ALBYHUB_URL إلزامي Base URL of the Alby Hub instance
  • ALBYHUB_TOKEN إلزامي سري Alby Hub API bearer token
  • ALBYHUB_READ_ONLY Set true to block all write operations (recommended for first-time setup)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. albyhub-admin-mcp
  2. The six tools
  3. Requirements
  4. Install
  5. Configure
  6. What if my Hub returns 404 on the typed wrappers?
  7. Safety model
  8. Companion servers
  9. License
  10. Contact / Issues

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

npx -y albyhub-admin-mcp

Configure

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.

  • NOSTR: npub1hdg932jvwc3jdvkqywgqv0ue4nn60exrf92asy8mtazt3hjg7d2s2yw0nw — follow, DM, zap.
  • Lightning Address: sovereigncitizens@getalby.com — for support zaps and "this was useful" tips.
  • Bug reports / feature requests: open a GitHub issue (link forthcoming).
  • Security issues: please disclose privately via NOSTR DM before opening a public issue.

الأسئلة الشائعة

ما هو io.github.llmops-pro/albyhub-admin-mcp؟

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

كيف أثبّت io.github.llmops-pro/albyhub-admin-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add albyhub-admin-mcp -e 'ALBYHUB_URL=<ALBYHUB_URL>' -e 'ALBYHUB_TOKEN=<your albyhub_token>' -e 'ALBYHUB_READ_ONLY=<ALBYHUB_READ_ONLY>' -- npx -y albyhub-admin-mcp@0.1.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.llmops-pro/albyhub-admin-mcp إلى مفتاح API؟

نعم. يتطلب ALBYHUB_URL, ALBYHUB_TOKEN، وتضبطها في إعداداته.

هل io.github.llmops-pro/albyhub-admin-mcp مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.llmops-pro/albyhub-admin-mcp؟

ينشره llmops-pro. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.