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