AI导哈

电力价格查询服务

获取由Red Eléctrica每日发布的电力消费价格（PVPC），适用于按2.0 TD电价计费的消费者。

  • by rfdez
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 rfdez/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.可选参数。
    • 返回：JSON格式的带有PVPC价格的文本内容。

🔧 配置

需求

您需要从注册API密钥 西班牙ESIOS电网 访问西班牙电力网络API。

API文档位于 API e·sios文档.

克劳德桌面版

远程服务器连接

打开克劳德桌面并导航到 Settings > Connectors > Add Custom Connector。输入名称如下 PVPC 以及远程MCP服务器URL，如 https://mcp.example.com/mcp.

本地服务器连接

将此添加到您的Claude桌面 claude_desktop_config.json 文件。看 克劳德桌面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检验员测试

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

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

相关 MCP