Pvpc MCP Server

🚀 小規模消費者向け自発的電力価格 (PVPC) MCPサーバー

このサーバーは、Red Eléctricaによって毎日午後8時15分に公開される小規模消費者向け自発的電力価格 (PVPC) を取得します。これには、2.0 TD料金体系で請求される消費者に次の日に適用される時間別の電力料金が含まれます。

🚀 クイックスタート

このサーバーを使用することで、Red Eléctricaによって公開される小規模消費者向け自発的電力価格 (PVPC) を取得することができます。以下のセクションでは、コンポーネント、設定、開発方法などについて説明します。

✨ 主な機能

• 指定された日付範囲と地理的エリアの小規模消費者向け自発的電力価格 (PVPC) を取得します。
• 複数のパラメータを使用して、取得するデータをフィルタリングおよび集約することができます。

📦 インストール

必要条件

Esios Red Eléctrica de España からAPIキーを登録する必要があります。APIのドキュメントは API e·sios Documentation で確認できます。

Smitheryを使用したインストール

Smithery を介して、任意のクライアントに自動的にPVPC MCPサーバーをインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli@latest install @rfdez/pvpc-mcp-server --client <CLIENT_NAME> --profile <YOUR_SMITHERY_PROFILE> --key <YOUR_SMITHERY_KEY>

Smitheryのプロファイルとキーは、Smithery.aiのWebページ で確認できます。

Claude Desktopとの接続

リモートサーバー接続

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

ローカルサーバー接続

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"]
    }
  }
}

💻 使用例

基本的な使用法

# このコマンドは、今日のPVPC価格を取得します
node dist/index.js

高度な使用法

# httpトランスポートとポート8080を使用してサーバーを起動します
node dist/index.js --transport http --port 8080

# stdioトランスポートを使用してサーバーを起動します
node dist/index.js --transport stdio --api-key YOUR_ESIOS_API_KEY

📚 ドキュメント

🧩 コンポーネント

ツール

• 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 (España), 8741 (Península), 8742 (Canarias), 8743 (Baleares), 8744 (Ceuta), 8745 (Melilla)。デフォルトは 8741, 8742, 8743, 8744, 8745。
    • geographicalTruncation: 地理的集約が指定された場合に、データを地理的レベルでグループ化する方法を指定します。許容値: country, electric_system。オプションパラメータ。
  • 戻り値: PVPC価格をJSON形式で含むテキストコンテンツ。

🔧 設定

開発

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

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キー。

ローカル設定例

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

MCPインスペクターでのテスト

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

📄 ライセンス

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