kardashev-mcp

kardashev-mcp

Kardashev Labs の米国電力網データを提供する MCP サーバーです。エージェントに、リアルタイムの LMP、炭素強度、負荷、出力抑制、系統連系キュー、ERCOT の大規模負荷、および公開されている RT−DA スプレッド予測の実績を提供します。API キーは不要です。

データは、data.kardashevlabs.org の公開 API から取得します。

インストール

npx -y kardashev-mcp

Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "kardashev": {
      "command": "npx",
      "args": ["-y", "kardashev-mcp"]
    }
  }
}

Claude Code

claude mcp add kardashev -- npx -y kardashev-mcp

ツール

ツール	返される内容
list_isos	対応する ISO/RTO とリアルタイムのデータ取り込み状況
get_fuel_mix	燃料種別の発電量（MW）
get_carbon	炭素強度（lbs CO₂/MWh）
get_lmp	地点別限界価格（RT/DA）
get_load	電力網の実負荷（MW）
get_load_forecast	近い将来の負荷予測
get_curtailment	太陽光／風力の出力抑制
get_queue	系統連系キューのプロジェクト
get_large_load	ERCOT の大規模負荷系統連系スナップショット
get_spread_forecast	リアルタイムの ERCOT RT−DA スプレッド予測（電力供給前に発行）
get_forecast_track_record	スプレッドモデルの評価済み公開実績

行を返すツールの limit のデフォルト値は 50（上限は 500）です。これにより、エージェントがコンテキストの予算内に収まるようにします。

任意の環境変数

変数	デフォルト	用途
KARDASHEV_BASE_URL	https://data.kardashevlabs.org	API のベース URL（ローカルのデータプレーン）を上書きします
KARDASHEV_TIMEOUT_MS	30000	リクエストごとのタイムアウト

開発

npm install
npm run build
npm start                 # stdio
npm run inspect           # MCP Inspector

リンク

• ウェブサイト：kardashevlabs.org
• 予測実績：kardashevlabs.org/forecast
• API ドキュメント：data.kardashevlabs.org/docs
• Python クライアント：kardashev
• JS/TS クライアント：kardashev

ライセンス

MIT