Pvpc MCP Server

🚀 小型消費者自願電價（PVPC）MCP 服務器

該項目可獲取西班牙電網公司（Red Eléctrica）每天晚上 8 點 15 分公佈的小型消費者自願電價（PVPC）。其中包含了次日適用於 2.0 TD 電價計費消費者的每小時電價信息。

🚀 快速開始

本項目用於獲取西班牙電網公司每日發佈的小型消費者自願電價（PVPC），若你想使用該項目，可按以下步驟操作：

1. 從 Esios Red Eléctrica de España 獲取 API 密鑰。
2. 按照不同客戶端的配置方法進行配置。
3. 若需開發，則克隆倉庫、安裝依賴、構建項目後運行服務器。

✨ 主要特性

• 能夠獲取指定日期範圍和地理區域的小型消費者自願電價（PVPC）。
• 支持多種參數配置，如日期範圍、時間聚合方式、地理區域篩選等。
• 可通過不同客戶端（如 Smithery、Claude Desktop）自動安裝或配置使用。

📦 安裝指南

配置要求

你需要從 Esios Red Eléctrica de España 註冊一個 API 密鑰，才能訪問西班牙電網公司的 Esios 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.ai 網頁 找到你的 Smithery 配置文件和密鑰。

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 文檔。

{
  "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

🔧 技術細節

工具組件

• 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 格式文本內容。

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE 文件。