poworacle

poworacle

MCP ツールで利用できる、リアルタイムのプルーフ・オブ・ワーク（PoW）マイニングデータです。ソロマイナーがブロックを採掘するまでの待ち時間、1 コインの採掘コスト、ネットワークの現在の状態、各ハードウェアの収益、最近のマイニングニュースを確認できます。

poworacle は、API キーを必要としない転送クライアントです。stdio MCP 経由（および CLI サブコマンド）で 6 つのツールを提供し、各呼び出しを公開されている BackPow MCP エンドポイント https://mcp.backpow.com/mcp に転送します。API キーも、アカウントも、設定も必要ありません。上流サーバーはステートレスなため、各呼び出しは tools/call JSON-RPC リクエストを含む単一の Streamable HTTP POST です。上流から返された結果のコンテンツは、そのまま返されます。上流の JSON-RPC エラーは backpow error: <message> として、解析できないレスポンスは backpow error: malformed response として返されます。タイムアウトを含む通信障害は backpow unreachable として返されます。

2 つの環境変数でクライアントの動作を調整できます（どちらもこの再構築版独自の設定であり、上流側の要件ではありません）。

変数	デフォルト	用途
BACKPOW_MCP_URL	https://mcp.backpow.com/mcp	エンドポイントの上書き
BACKPOW_TIMEOUT_MS	30000	呼び出しごとのタイムアウト。AbortController によって適用されます

ツール

ツール	確認できる内容
calculate_solo_mining_odds	指定したコインとハッシュレートでのブロック採掘までの平均時間、1／7／30／90／365 日間におけるポアソン分布に基づく確率、および試行にかかる電気料金
get_cost_of_production	追跡対象の最も効率的なハードウェアを使って 1 単位を採掘する際の電気料金の総額。現物価格および利益幅との比較も表示します
get_coin_oracle	1 つのチェーンのリアルタイムな難易度、ハッシュレート、ブロック高、報酬、および測定信頼度を示すブロック
list_pow_coins	アルゴリズムまたは収益性で絞り込める、追跡対象の PoW ネットワーク一覧。ページネーションに対応しています
get_hardware_benchmarks	指定した電気料金における 1 日あたりの純利益（USD）順に、採掘可能なコインと対応するハードウェアを表示します
get_pow_news	最近の PoW マイニングとネットワークのニュース。必要に応じて 1 つのコインに絞り込めます

曖昧な場合や測定値が不足している場合、上流側は推測や代替を行わずにリクエストを拒否します。これらのエラーは backpow error: の形式に変換される点を除き、そのまま返されます。

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

各ツールのサブコマンドには、1 つの JSON 引数文字列を指定します。終了コード：成功時は 0、ツール結果がエラーの場合は 1、使用方法に誤りがある場合（不明なコマンド、余分な引数、オブジェクト以外の JSON 引数）は 2 です。

MCP

npx @reneturcios/poworacle mcp

MCP クライアントの設定：

{
  "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"}'

開発

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

ライセンス

MIT — LICENSE を参照してください。