Gas Prices Today MCP

gas-prices-today-mcp

为 AI 助手提供今日油价。询问你所在州或城市本周每加仑的价格，即可获取美国能源信息署（EIA）发布的普通、中级、高级汽油或柴油均价，以及与上周、上个月和一年前相比的变化，还有加满油箱或驾车出行的费用。

这是一个模型上下文协议（MCP）服务。它会在调用时读取 EIA 每周零售汽油和柴油调查数据，无需 API 密钥。

工具

工具	返回内容
get_gas_prices	本周 EIA 发布的美国、一个地区、九个受调查州之一、十个受调查城市之一，或任何其他州所属地区的每加仑零售均价（含税），以及与上周、四周前和一年前相比的变化。
compare_gas_prices	按价格从低到高排列的 EIA 州、城市和地区油价，并与美国均价进行比较。
estimate_fill_up_cost	按当地均价或你提供的价格计算加满油箱的费用，并根据里程和每加仑行驶里程计算行程费用。

每个结果都包含结构化 JSON、一段摘要、as_of、source 和 more（mcpstamp.com 上的页面）。所有工具均标记为只读。

它掌握而你的模型并不知道的信息

• 本周的价格。EIA 每周一发布新的均价，因此记忆中的数字已经过时。
• EIA 实际公布哪些地区的价格。覆盖美国、五个包含子区域的区域、九个州（California、Colorado、Florida、Massachusetts、Minnesota、New York、Ohio、Texas、Washington）和十个城市。对于其他州，服务会说明这一点，并返回其所属的 EIA 区域。
• 一年前的价格，读取自 EIA 每周历史文件。

安装

托管服务（Claude.ai 自定义连接器、ChatGPT 开发者模式）

粘贴此 URL。无需令牌，也无需注册。

https://gas-prices-today-mcp.lipmichal.workers.dev/mcp

Claude Code

claude mcp add --transport http gas-prices-today https://gas-prices-today-mcp.lipmichal.workers.dev/mcp

Claude Desktop

在 Claude Desktop 中，前往 Settings、Connectors、Add custom connector 添加远程服务。粘贴上方的 URL。

Cursor

添加到 ~/.cursor/mcp.json。

{
  "mcpServers": {
    "gas-prices-today": { "url": "https://gas-prices-today-mcp.lipmichal.workers.dev/mcp" }
  }
}

VS Code

添加到 .vscode/mcp.json。

{
  "servers": {
    "gas-prices-today": { "type": "http", "url": "https://gas-prices-today-mcp.lipmichal.workers.dev/mcp" }
  }
}

本地 stdio

npm 包尚未发布。使用 Node 20 或更高版本从此仓库构建。

git clone https://github.com/theluckystrike/gas-prices-today-mcp && cd gas-prices-today-mcp
npm install && npm run build
claude mcp add gas-prices-today -- node $(pwd)/dist/stdio.js

提示词示例

• “今天的油价是多少？”
• “Texas 现在普通汽油每加仑多少钱？一年前又是多少？”
• “EIA 调查的州中，哪个州的油价最高？”
• “California 本周柴油价格是多少？”
• “以每加仑行驶 30 英里的油耗行驶 300 英里，需要花多少钱？”

数据来源

完整列表及抓取日期见 DATA_SOURCES.md。

• EIA 每周零售汽油和柴油价格，调用时读取各地区普通、中级、高级、所有等级汽油及柴油价格表。
• EIA 每周历史页面（LeafHandler），用于获取一年前的价格。
• EIA PADD 定义，用于确定各州所属区域。

局限性

• 州、城市和区域均价来自零售调查，并非你所在加油站的价格。
• EIA 直接公布九个州和十个城市的价格。其他州使用其所属区域的均价。
• 柴油价格仅针对美国、各区域和 California。
• 托管服务对 EIA 页面缓存最长可达 15 分钟。

更多

在 mcpstamp.com 上可以找到更多能回答助手无法独自解答问题的 MCP 服务。

这是 Zovo MCP 集合的一部分，网址为 https://mcp.zovo.one

由 theluckystrike 构建。

开发

npm install
npm test                              # builds, then runs the fixture tests and an offline stdio test
node scripts/stdio-transcript.mjs     # live stdio round trip, writes .live/stdio-transcript.jsonl

许可证

MIT