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 价格的文本内容。

🔧 配置

要求

你需要从 Esios Red Eléctrica de España 注册 API 密钥，才能访问 Esios Red Eléctrica de España API。

你可以在 API e·sios Documentation 中找到 API 文档。

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

💻 开发

克隆此代码库并安装依赖项：

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