pvpc-mcp-server

小規模消費者向け任意料金（PVPC）MCP サーバー

Red Eléctrica が毎日午後 8 時 15 分に公開する小規模消費者向け任意料金（PVPC）を取得します。これには、2.0 TD 料金プランで請求される消費者に翌日適用される時間別電気料金が含まれます。

🧩 コンポーネント

ツール

• fetch_prices：指定した日付範囲と地域の小規模消費者向け任意料金（PVPC）を取得します。
  • 入力：
    • locale：ソースの翻訳を取得します。指定できる値は es、en です。デフォルトは es です。
    • startDate：指標値を絞り込む日付範囲の開始日時です。iso8601 形式で指定します。例：2025-06-29T00:00:00.000+02:00。デフォルトは本日の開始時刻です。
    • endDate：指標値を絞り込む日付範囲の終了日時です。iso8601 形式で指定します。例：2025-06-29T23:59:59.999+02:00。デフォルトは本日の終了時刻です。
    • timeAggregation：時間別にグループ化する際の指標値の集計方法です。指定できる値は sum、average です。デフォルトは sum です。
    • timeTruncation：データの時系列を切り捨てる単位を指定します。指定できる値は hour、day、month、year です。省略可能なパラメーターです。
    • geographicalAggregation：地理 ID ごとにグループ化する際の指標値の集計方法です。指定できる値は sum、average です。デフォルトは sum です。
    • geographicalIds：指標値を絞り込む地理 ID を指定します。指定できる値は 3（スペイン）、8741（半島部）、8742（カナリア諸島）、8743（バレアレス諸島）、8744（セウタ）、8745（メリリャ）です。デフォルトは 8741、8742、8743、8744、8745 です。
    • geographicalTruncation：地理的集計が指定されている場合に、地理レベルでデータをグループ化する方法を指定します。指定できる値は country、electric_system です。省略可能なパラメーターです。
  • 戻り値：PVPC 料金を JSON 形式で含むテキストコンテンツです。

🔧 設定

要件

Esios Red Eléctrica de España API にアクセスするには、Esios Red Eléctrica de España で API キーを登録する必要があります。

API ドキュメントは API e·sios Documentation で確認できます。

Claude Desktop

リモートサーバーへの接続

Claude Desktop を開き、Settings > Connectors > Add Custom Connector に移動します。名前に PVPC を入力し、https://mcp.example.com/mcp のようなリモート MCP サーバーの URL を入力します。

ローカルサーバーへの接続

Claude Desktop の claude_desktop_config.json ファイルに以下を追加します。詳しくは Claude Desktop MCP docs をご覧ください。

{
  "mcpServers": {
    "pvpc": {
      "command": "npx",
      "args": ["-y", "@rfdez/pvpc-mcp-server@latest", "--api-key", "your_esios_api_key"]
    }
  }
}

💻 開発

このリポジトリをクローンし、依存関係をインストールします。

npm install

プロジェクトをビルドします。

npm run build

サーバーを起動します。

node dist/index.js

CLI 引数

pvpc-mcp-server では、以下の CLI フラグを指定できます。

• --transport <stdio|http>：使用するトランスポートです（デフォルトは stdio）。
• --port <number>：http トランスポート使用時にリッスンするポートです（デフォルトは 8080）。
• --api-key <key>：認証に使用する e·sios API キーです。

http トランスポートとポート 8080 を使用する例：

node dist/index.js --transport http --port 8080

stdio トランスポートを使用する例：

node dist/index.js --transport stdio --api-key YOUR_ESIOS_API_KEY

ローカル設定の例

{
  "mcpServers": {
    "pvpc": {
      "command": "npx",
      "args": ["-y", "tsx", "/path/to/folder/pvpc-mcp-server/src/index.ts", "--api-key", "YOUR_ESIOS_API_KEY"]
    }
  }
}

MCP Inspector を使ったテスト

npx -y @modelcontextprotocol/inspector npx -y @rfdez/pvpc-mcp-server

ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。