pvpc-mcp-server

@rfdez/pvpc-mcp-server

Hosted

0 Stars 5 次浏览 rfdez 更新于 2026-08-23

Retrieve daily PVPC electricity tariffs for 2.0 TD consumers, published by Red El茅ctrica.

金融

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "@rfdez/pvpc-mcp-server": {
      "args": [
        "@rfdez/pvpc-mcp-server@3.2.3"
      ],
      "command": "npx"
    }
  }
}

可用工具（5 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

tavily_search 14 个参数需填 1 项 Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

必填参数：query

tavily_extract 6 个参数需填 1 项 Extract content from URLs. Returns raw page content in markdown or text format.

Extract content from URLs. Returns raw page content in markdown or text format.

必填参数：urls

tavily_crawl 11 个参数需填 1 项 Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

必填参数：url

tavily_map 8 个参数需填 1 项 Map a website's structure. Returns a list of URLs found starting from the base URL.

Map a website's structure. Returns a list of URLs found starting from the base URL.

必填参数：url

tavily_research 2 个参数需填 1 项 Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.

Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.

必填参数：input

服务介绍

Voluntary Price for the Small Consumer (PVPC) MCP Server

Fetch the Voluntary Price for the Small Consumer (PVPC) published daily by Red Eléctrica at 8:15 p.m. This includes the hourly electricity tariffs that will apply the following day for consumers billed under the 2.0 TD tariff.

# 🧩 Components

# # Tools

fetch_prices: Fetches the Voluntary Price for the Small Consumer (PVPC) prices for a given date range and geographical area.
- Inputs:
  - locale: Get translations for sources. Accepted values: es, en. Defaults to es.
  - startDate: Beginning of the date range to filter indicator values in iso8601 format. E.g. 2025-06-29T00:00:00.000+02:00. Defaults to the start of today.
  - endDate: End of the date range to filter indicator values in iso8601 format. E.g. 2025-06-29T23:59:59.999+02:00. Defaults to the end of today.
  - timeAggregation: How to aggregate indicator values when grouping them by time. Accepted values: sum, average. Defaults to sum.
  - timeTruncation: Tells how to truncate data time series. Accepted values: hour, day, month, year. Optional parameter.
  - geographicalAggregation: How to aggregate indicator values when grouping them by geographical ID. Accepted values: sum, average. Defaults to sum.
  - geographicalIds: Tells the geographical IDs to filter indicator values. Accepted values: 3 (España), 8741 (Península), 8742 (Canarias), 8743 (Baleares), 8744 (Ceuta), 8745 (Melilla). Defaults to 8741, 8742, 8743, 8744, 8745.
  - geographicalTruncation: Tells how to group data at geographical level when the geographical aggregation is informed. Accepted values: country, electric_system. Optional parameter.
- Returns: Text content with the PVPC prices in JSON format.

# 🔧 Configuration

# # Requirements

You need to register an API key from Esios Red Eléctrica de España to access the Esios Red Eléctrica de España API.

You will find the API documentation at API e·sios Documentation.

# # Claude Desktop

# # # Remote Server Connection

Open Claude Desktop and navigate to Settings > Connectors > Add Custom Connector. Enter the name as PVPC and the remote MCP server URL like https://mcp.example.com/mcp.

# # # Local Server Connection

Add this to your Claude Desktop claude_desktop_config.json file. See Claude Desktop MCP docs for more info.

{
  "mcpServers": {
    "pvpc": {
      "command": "npx",
      "args": ["-y", "@rfdez/pvpc-mcp-server@latest", "- -api-key", "your_esios_api_key"]
    }
  }
}

# 💻 Development

Clone this repository and install the dependencies:

npm install

Build the project:

npm run build

Run the server:

node dist/index.js

# # CLI Arguments

pvpc-mcp-server accepts the following CLI flags:

- -transport <stdio|http>: Transport to use (stdio by default).
- -port <number>: Port to listen on when using http transport (default 8080).
- -api-key <key>: Your e·sios API key for authentication.

Example with http transport and port 8080:

node dist/index.js - -transport http - -port 8080

Example with stdio transport:

node dist/index.js - -transport stdio - -api-key YOUR_ESIOS_API_KEY

# # Local Configuration Example

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

# # Testing with MCP Inspector

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

# License

This project is licensed under the MIT License - see the LICENSE file for details.

查看源码项目主页