English Français العربية

io.github.CloudCorpRecords/poworacle

السجل الرسمي أخرى

Proof-of-work mining oracle: solo-mining odds, cost of production, network state, hardware, news.

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

التثبيت

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

NPM package @reneturcios/poworacle
Claude Code 
claude mcp add poworacle -- npx -y @reneturcios/poworacle@0.1.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "poworacle": {
            "command": "npx",
            "args": [
                "-y",
                "@reneturcios/poworacle@0.1.0",
                "mcp"
            ]
        }
    }
}
OCI package ghcr.io/cloudcorprecords/poworacle:0.1.0
Claude Code 
claude mcp add poworacle -- docker run -i --rm ghcr.io/cloudcorprecords/poworacle:0.1.0 mcp
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "poworacle": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/cloudcorprecords/poworacle:0.1.0",
                "mcp"
            ]
        }
    }
}

التوثيق

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

المحتويات
  1. poworacle
  2. Tools
  3. CLI
  4. MCP
  5. Docker
  6. Development
  7. License

poworacle

Live proof-of-work mining data as MCP tools: how long a solo miner would wait for a block, what it costs to produce one coin, the current state of a network, which hardware earns what, and recent mining news.

poworacle is a keyless forwarding client. It serves six tools over stdio MCP (and as CLI subcommands) and forwards each call to the public BackPow MCP endpoint at https://mcp.backpow.com/mcp — no API key, no account, nothing to configure. The upstream server is stateless, so each call is a single Streamable HTTP POST carrying a tools/call JSON-RPC request; the upstream result's content is returned verbatim. Upstream JSON-RPC errors come back as backpow error: <message>, an unparseable response as backpow error: malformed response, and a transport failure (including a timeout) as backpow unreachable.

Two environment variables adjust the client (both are this rebuild's own knobs, not upstream requirements):

VariableDefaultPurpose
BACKPOW_MCP_URLhttps://mcp.backpow.com/mcpEndpoint override
BACKPOW_TIMEOUT_MS30000Per-call timeout, AbortController-enforced

Tools

ToolAnswers
calculate_solo_mining_oddsMean time to a block and Poisson odds over 1/7/30/90/365 days for a given coin and hashrate, plus the electricity cost of the attempt
get_cost_of_productionAll-in electricity cost of mining one unit on the most efficient tracked hardware, against spot price and margin
get_coin_oracleLive difficulty, hashrate, block height and reward for one chain, with a measurement-confidence block
list_pow_coinsPaginated catalogue of tracked PoW networks, filterable by algorithm or profitability
get_hardware_benchmarksHardware matched to the coins it can mine, ranked by net USD per day at a given electricity rate
get_pow_newsRecent PoW mining and network news, optionally filtered to one coin

Ambiguity and missing measurements are refused upstream rather than guessed or substituted, and those errors pass through unchanged apart from the backpow error: rendering.

CLI

npx @reneturcios/poworacle get_coin_oracle '{"coin_id":"Kaspa"}'
npx @reneturcios/poworacle calculate_solo_mining_odds '{"coin_id":"Bitcoin","hashrate":100,"hashrate_unit":"TH/s"}'
npx @reneturcios/poworacle list_pow_coins '{"algorithm":"SHA-256"}'
npx @reneturcios/poworacle --version

Each tool subcommand takes one JSON argument string. Exit codes: 0 on success, 1 when the tool result is an error, 2 on a usage error (unknown command, extra arguments, or a non-object JSON argument).

MCP

npx @reneturcios/poworacle mcp

MCP client configuration:

{
  "mcpServers": {
    "poworacle": {
      "command": "npx",
      "args": ["-y", "@reneturcios/poworacle", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/poworacle          # stdio MCP server (CMD defaults to "mcp")
docker run --rm ghcr.io/cloudcorprecords/poworacle get_pow_news '{"coin_id":"Bitcoin"}'

Development

npm install
npm run build      # tsc -> dist/ (dist/cli.js is the bin)
npm test           # tsx --test test/*.test.ts (fake fetch only, no network)
npm run dev        # tsx src/cli.ts — run the CLI from source

License

MIT — see LICENSE.

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

ما هو io.github.CloudCorpRecords/poworacle؟

Proof-of-work mining oracle: solo-mining odds, cost of production, network state, hardware, news.

كيف أثبّت io.github.CloudCorpRecords/poworacle؟

يعمل على جهازك. في Claude Code: claude mcp add poworacle -- npx -y @reneturcios/poworacle@0.1.0 mcp. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.CloudCorpRecords/poworacle إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.CloudCorpRecords/poworacle مفتوح المصدر؟

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

من يصون io.github.CloudCorpRecords/poworacle؟

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

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