Pvgis

@pipeworx/pvgis

PVGIS MCP — EU JRC 太陽光発電地理情報システム。あらゆる場所の太陽光発電システムの出力をモデル化します。認証は不要です。

Pipeworx の一部です。AI エージェントを1683以上のライブデータソースに接続するMCPゲートウェイです。

ツール

• pv_performance(latitude, longitude, peakpower, ...) — 年間／月間の太陽光発電量の推定
• tmy(latitude, longitude, year_min?, year_max?) — 典型気象年（毎時）
• monthly_radiation(latitude, longitude, ...) — 長期の月間日射量

データソース

https://re.jrc.ec.europa.eu/api/v5_3/ — 公開されており、認証は不要です。

対応範囲：全世界。ただし、PVGIS-SARAH3、PVGIS-NSRDB、PVGIS-ERA5を使用するため、ヨーロッパ／アフリカ／アジアで最も正確です。

クイックスタート

MCP クライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

{
  "mcpServers": {
    "pvgis": {
      "url": "https://gateway.pipeworx.io/pvgis/mcp"
    }
  }
}

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/pvgis/mcp の tools/list は、上の表のツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール一式）も返します。そのため、表示されるツール数はこの表より多くなります。現在、単一パックのエンドポイントには、パック固有のツールに加えて、およそ30個の共有ツールが表示されます。接続の initialize レスポンスには正確な範囲が示され、その日の状況を確認するための正式な情報となります。

これは意図的な仕様であり、偶然に多重化されているわけではありません。メタツールを使うと、このパックでは対応できない質問にも、カタログ全体を検索する ask_pipeworx 経由で回答できます。そのため、MCP サーバーを追加する必要はありません。現在、メタツールを含めずにパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費が、ルーティングの利点を上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度接続してください。

または、Pipeworx のフルゲートウェイに接続すると、このパックだけでなく、すべてのパックのツールが直接一覧表示されます。

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

どちらの URL も、同じゲートウェイと同じ1683以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。どちらからでも、ask_pipeworx を使ってすべてのツールにアクセスできます。

MCP クライアントがない場合：HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/pv_performance \
  -H 'Content-Type: application/json' \
  -d '{"latitude":40.7128,"longitude":-74.006,"peakpower":5,"loss":14,"angle":35,"aspect":0,"pvtechchoice":"crystSi"}'

最初の呼び出しにアカウントは不要です。ツールの詳細を確認するには、GET https://gateway.pipeworx.io/v1/tools/pv_performance を使います。ツールを検索するには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を使います。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージは、ローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへの往復通信も不要です。

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

または、直接実行して起動を確認します。

npx -y @pipeworx/mcp-pvgis

stdin/stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じデータソース、同じツールを使用しますが、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。この方法は、上記のパックエンドポイントでも、フルゲートウェイでも使えます。

ask_pipeworx({ question: "your question about Pvgis data" })

ゲートウェイが適切なツールを選び、引数を自動で入力します。

詳細

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT