Poworacle

io.github.CloudCorpRecords由 GitHub 账号 CloudCorpRecords 发布v0.1.0更新于 Nov 7, 2026

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

已验证STDIO仅桌面金融数据与分析

概览

AI 生成的概览

无需密钥的 MCP 客户端,将六项工作量证明挖矿工具转发到公开的 BackPow 端点:单机挖矿概率、生产成本、网络状态、硬件与新闻。

可以做什么
  • 按币种与算力估算单机挖矿概率及电力成本
  • 对比生产成本与现货价格及利润率
  • 读取链上实时状态:难度、算力、区块高度与奖励
  • 按算法或盈利性浏览已追踪的 PoW 币种
  • 按给定电价对矿机按每日净美元收益排序
  • 获取近期 PoW 挖矿与网络新闻,可按币种筛选
适用场景
适合涉及工作量证明挖矿经济性的问题:单机挖矿是否划算、某币种的生产成本、网络当前表现、哪种硬件更赚钱,或近期挖矿新闻。
运行要求
通过 npx 或 Docker 以 stdio 在本地运行,需要能访问公开的 BackPow 端点。无需账号或 API 密钥。可选环境变量 BACKPOW_MCP_URL 与 BACKPOW_TIMEOUT_MS 用于调整端点和单次调用超时。
安装前请注意
每次工具调用都会转发到第三方端点,因此你提供的币种、算力与电价等输入会离开本机。结果为只读数据;硬件价格等数值可能是模型估算而非实际挂牌价,新闻条目为引用的第三方内容。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Poworacle,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

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

bash
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

bash
npx @reneturcios/poworacle mcp

MCP client configuration:

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

Docker

bash
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

bash
npm installnpm 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.

来源:README.md,提交 d3c9f58

工具

6

calculate_solo_mining_odds

Solo mining odds

Probability of a solo miner finding a block, computed as a Poisson process over live network difficulty and hashrate, plus the electricity cost of the attempt. Returns mean time to a block, the chance of at least one block over 1/7/30/90/365 days, and lucky-vs-unlucky waiting times (5th, 50th and 95th percentile) — variance dominates at small hashrates, so the average alone is misleading. Use for questions like "how long would it take to solo mine a Bitcoin block with 100 TH/s", "what are my odds solo mining Kaspa", or "is solo mining worth it with this rig". For pooled mining economics or whether a coin is profitable at all, use get_cost_of_production. For raw network state without a miner, use get_coin_oracle.

输入参数coin_id必填hashrate必填power_wattshashrate_unit必填electricity_cost_usd_kwh

get_cost_of_production

Cost of production

Cost of Production (CoP) for one Proof of Work coin: the all-in electricity cost of mining one unit on the most efficient hardware BackPow tracks for that algorithm, compared against spot price. Returns CoP in USD, spot, gross margin, whether miners are currently above or below water, the reference machine and tariff behind the figure, and a 30-day trend including whether the reference machine changed (which indicates the efficiency frontier moved). Accepts a custom electricity rate. Use for "is mining X profitable", "what does it cost to produce one Monero", "are miners underwater", or "break-even electricity price". For a specific rig rather than a coin, use get_hardware_benchmarks. For block-finding probability, use calculate_solo_mining_odds.

输入参数coin_id必填electricity_cost_usd_kwh

get_coin_oracle

Live network state

Current network state for one Proof of Work chain, measured by BackPow's stratum collector nodes: difficulty, derived network hashrate, block height, block reward, protocol block-time target versus the latest observed interval, and the source pool. Every response carries a confidence block — how many independent pool operators agreed, whether the reward figure is live or a static fallback, and how old the observation is. Networks whose collectors are stalled or unreachable return an error rather than zeros. Use for "what is Kaspa's current difficulty", "network hashrate of Monero", "current block reward". For economics use get_cost_of_production; for mining probability use calculate_solo_mining_odds.

输入参数coin_id必填

list_pow_coins

Browse PoW networks

Paginated index of the Proof of Work networks BackPow tracks, with algorithm, network rate, collector status and canonical page URL. Optionally filtered by algorithm or restricted to coins currently mining above cost. Returns the distinct algorithm list so valid filter values are discoverable. Use to find which networks exist for an algorithm, to browse the catalogue, or to resolve an ambiguous coin reference. Results are paginated: request a larger limit or a later offset rather than expecting the full catalogue in one response.

输入参数limitoffsetsort_byalgorithmprofitable_only

get_hardware_benchmarks

Mining hardware economics

Mining hardware matched to the coins it can mine, ranked by net USD per day at a given electricity rate. Covers ASICs, GPUs and CPUs, with hashrate and power draw per coin, gross revenue, net profit, and market price including whether that price is an observed listing or a model estimate. Use for "what should I mine with an RTX 4090", "best ASIC for Scrypt", "is an Antminer S21 still profitable", or "how much does a Bitaxe make". Coins are ranked by profitability, not alphabetically, and results are capped — ask for a higher limit rather than assuming the list is complete. For a coin's economics independent of any particular rig, use get_cost_of_production.

输入参数typelimitquery必填coin_idelectricity_cost_usd_kwh

get_pow_news

PoW mining news

Recent news items about Proof of Work mining and network events, optionally filtered to one coin. Items are aggregated from third-party feeds and are returned as quoted external content with their publisher and a relevance score, not as BackPow statements of fact. Use when a question turns on recent events — a halving, a difficulty swing, a pool outage, a chain upgrade. For numbers rather than narrative, use get_coin_oracle or get_cost_of_production.

输入参数limitcoin_idinclude_low_signal

版本历史

1
  1. v0.1.0最新Nov 4, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分