Solar Data

サーバーを1つインストールするだけで — uvx solar-data-mcp — エージェントは4つのデータ領域（発電量モデリング、経済性、市場データ、予測）にわたる18個のツール、使い方を教える11個のスキル、すぐに使えるレポート用プロンプト4個を利用できます。すべてのツールが同じ形式 — data + units + source + assumptions + warnings — で結果を返すため、エージェントは数値の意味、出典、代わりに適用されたデフォルト値を常に把握できます。

何を質問できますか？

• 自宅への太陽光導入を検討する — 「自宅に6 kWのシステムを導入したら元が取れますか？」 · 「この21,000ドルの見積もりは妥当ですか？」 · 「明日、太陽光発電設備はどれくらい発電しますか？」
• 太陽光発電を販売・設置する — 「この顧客向けに提案書を作成して」 · 「フェニックスでの許可取得にはどれくらいかかりますか？」 · 「次にどこへ事業を拡大すべきですか？」
• 市場を調査する — 「テキサス州の太陽光市場について概要を教えて」 · 「コロラド州の設置価格はどのように推移していますか？」 · 「蓄電池を備えた大規模発電所はどれですか？」

エージェントは質問ごとに適切なツールを選び（またはスキルが振り分け）、すべての数値に単位、出典、代わりに適用された前提条件が付いて返されます。

クイックスタート

1. 無料のNREL APIキーを取得する — https://developer.nlr.gov/signup/ （または、試用には DEMO_KEY を使えます。1時間あたり10リクエストまでです）。

2. エージェントにサーバーを追加する — 以下に主要なエージェントごとの設定例があります。Claude Desktopの場合は、これを claude_desktop_config.json に統合してください （完全な例は examples/ にあります）。

   {
     "mcpServers": {
       "solar-data": {
         "command": "uvx",
         "args": ["solar-data-mcp"],
         "env": {
           "NREL_API_KEY": "YOUR_KEY_HERE",
           "OPENEI_API_KEY": "YOUR_KEY_HERE",
           "EIA_API_KEY": "YOUR_KEY_HERE"
         }
       }
     }
   }
   

   最初に必要なのは NREL_API_KEY だけです。サーバーはキーが一部だけ設定されていても動作し、キーがないツールは何も通知せず失敗するのではなく、設定方法を案内します。

3. クライアントを再起動して質問する — 次の質問を試してください。 「アリゾナ州メサの8 kWシステムで、傾斜角10°と25°の場合の年間発電量を比較して。」

キーと接続はいつでも確認できます。

$ uvx solar-data-mcp doctor

エージェントに追加する

Claude Code

$ claude mcp add solar-data \
    --env NREL_API_KEY=YOUR_KEY --env OPENEI_API_KEY=YOUR_KEY --env EIA_API_KEY=YOUR_KEY \
    -- uvx solar-data-mcp

（または、クイックスタートのJSONをプロジェクトの .mcp.json にコミットしてください）

Codex CLI — ~/.codex/config.toml：

[mcp_servers.solar-data]
command = "uvx"
args = ["solar-data-mcp"]

[mcp_servers.solar-data.env]
NREL_API_KEY = "YOUR_KEY_HERE"
OPENEI_API_KEY = "YOUR_KEY_HERE"
EIA_API_KEY = "YOUR_KEY_HERE"

（または codex mcp add solar-data --env NREL_API_KEY=YOUR_KEY -- uvx solar-data-mcp を実行してください。 キーをハードコードせず、シェルから渡すには env_vars = ["NREL_API_KEY"] を使用します）

OpenCode — プロジェクト内の opencode.json（または ~/.config/opencode/opencode.json）：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "solar-data": {
      "type": "local",
      "command": ["uvx", "solar-data-mcp"],
      "enabled": true,
      "environment": {
        "NREL_API_KEY": "YOUR_KEY_HERE",
        "OPENEI_API_KEY": "YOUR_KEY_HERE",
        "EIA_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}

Hermes — ~/.hermes/config.yaml に設定し、その後 /reload-mcp を実行します。

mcp_servers:
  solar-data:
    command: "uvx"
    args: ["solar-data-mcp"]
    env:
      NREL_API_KEY: "YOUR_KEY_HERE"
      OPENEI_API_KEY: "YOUR_KEY_HERE"
      EIA_API_KEY: "YOUR_KEY_HERE"

Claude Desktop — 上記のクイックスタート用JSONを使用します。

MCPに対応するその他のサービス（stdio） — コマンドは uvx、引数は ["solar-data-mcp"]、キーは env ブロックに設定します。

API キー

すべて無料で、どれも任意です。設定しなくてもサーバーは起動します。

環境変数	利用できる機能	入手先
NREL_API_KEY	estimate_production, get_solar_resource, compare_orientations, size_system_for_target, estimate_roi, compare_forecast_to_model	https://developer.nlr.gov/signup/
OPENEI_API_KEY	lookup_tariffs	https://openei.org/services/api/signup/
EIA_API_KEY	get_electricity_prices	https://www.eia.gov/opendata/register.php
AHJ_REGISTRY_TOKEN（任意）	identify_ahj	[email protected] にメールしてください

市場ツール（USPVDB、Tracking the Sun、SolarTRACE）と予測にはキーは不要です。 予測の完全な出力には、Quartz モデルを永続環境にインストールする必要があります （packages/solar-forecast/ を参照）。 インストールされていない場合、予測ツールはインストール手順を返します。

サーバー

uvx solar-data-mcp — 上記のインストール方法 — を使うと、1 つの stdio エントリで 4 つすべてのドメインを提供します。 各ドメインは、単独のサーバーとしても提供されています。

ドメイン	データ	単独サーバー
発電量	PVWatts v8 のモデリング、NSRDB の日射量	uvx --from solar-data-mcp-nrel nrel-solar-mcp
経済性	URDB の料金、EIA の価格、連邦 ITC ＋ DSIRE	uvx --from solar-data-mcp-economics solar-economics-mcp
市場	SolarTRACE、Tracking the Sun、USPVDB、AHJ の検索	uvx --from solar-data-mcp-market solar-market-mcp
予測	Quartz のオープンソース予測（OCF）	uvx --from solar-data-mcp-forecast solar-forecast-mcp

サーバーごとの設定： examples/claude_desktop_config.per-server.json。

⚠️ 統合版の solar-data サーバーとドメイン別サーバーは、どちらか一方のみを実行してください。また、solar-economics と solar-market を同時に実行しないでください。どちらも同じローカルの DuckDB 一括データストアを開きますが、同時に使用できるプロセスは 1 つだけです。

ツール

4 つのドメインにわたる 18 個のツールがあります。パラメーターの詳細は各ツールの docstring と各ドメインパッケージの README に記載されています。

ドメイン	質問できる内容	ツール
発電量	発電量、日照、システムのサイズ、屋根の向き	estimate_production, get_solar_resource, compare_orientations, size_system_for_target
経済性	料金、電気料金、インセンティブ、投資回収	lookup_tariffs, get_electricity_prices, get_incentives, estimate_roi, sync_incentives
市場	設置済みシステムの $/W、許認可にかかる期間、電力会社規模の発電所	query_installed_systems, get_permitting_timelines, find_utility_scale_projects, identify_ahj, market_snapshot, sync_*
予測	明日の発電量、「今日はいつもと違うか？」	forecast_generation, compare_forecast_to_model

スキルとレポート

スキルは統合版サーバーに同梱された手順で、ツールを正しく連携させる方法（順序、同期の前提条件、誠実なレポート作成）をエージェントに教えます。これらは MCP リソースです。skill://solar/index は質問の種類に応じて振り分け、skill://solar/<name> は手順を示します。質問者別のグループ：

• 住宅所有者 — 設置場所の評価、見積もりの確認、性能のチェック
• 施工業者 — 提案書の作成、営業地域の拡大
• アナリスト — 市場概要、価格分析、電力会社規模の案件調査、インセンティブの調査
• 横断的な項目 — データ同期（一括スナップショット）、データ規約（データ形式の理解）

このうち 4 つは固定の文書構成でレポートを作成し、ホストがネイティブに表示できる MCP プロンプトとしても公開されています — market_brief、site_assessment、 quote_review、proposal_builder（Claude Code では /mcp__solar-data__market_brief）。

全カタログ、振り分けの設計、レポートテンプレートについては、docs/skills.md を参照してください。

開発

$ git clone https://github.com/hoodsy/solar-data-mcp && cd solar-data-mcp
$ uv sync                # install the workspace
$ uv run pytest          # fixture replay only, no network

構成：packages/core（共有 HTTP クライアント、キャッシュ、エンベロープ）、ドメインサーバーごとに 1 つのパッケージ、そして 4 つすべてを 1 つの stdio エントリでマウントする統合パッケージの packages/solar-data-mcp です。最小構成のクライアントは、examples/example_client.py をご覧ください。

ライセンス

MIT。ソースごとのデータライセンスと帰属表示は、MCP リソース（source://<name>/license）として公開されています。