实时油价查询服务

一个基于Tankerkoenig API的FastMCP服务器,提供德国各地实时油价查询功能,包括位置转换、附近加油站搜索及价格排序。

  • by jonasradke-dev
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 jonasradke-dev/gas-price-mcp

使用说明

德国天然气价格MCP服务器

FastMCP服务器,使用Tankerkoenig API为德国各地提供实时天然气价格。

特性

  • 使用OpenStreetMap/Nomingim将位置名称转换为坐标
  • 查找半径5公里内的附近加油站
  • 获取Diesel、E5和E10的当前价格
  • 按最便宜价格排序的结果

设置

  1. 安装依赖项:
pip install fastmcp requests python-dotenv
  1. 获取Tankerkoenig API密钥:
  • 注册地址:https://creativecommons.tankerkoenig.de/
  • 获取免费的API密钥
  1. 创建 .env 文件:
TANKERKOENIG_API_KEY=your_api_key_here

用法

启动服务器:

python server.py

服务器将在上运行 http://0.0.0.0:8000

可用工具:

  • get_gasprice_from_location(location: str) -获取德国任何地点的天然气价格

示例位置:

  • “柏林”
  • “慕尼黑”
  • “10115”(邮政编码)
  • Hauptstraße 1, 汉堡

运作原理

  1. 使用Nominim将位置字符串转换为纬度/经度
  2. 查询Tankerkoenig API 5公里范围内的车站
  3. 按最便宜的可用燃油价格对结果排序
  4. 返回前5个电台的价格和地址

Docker部署

Docker Compose(推荐)

在您的服务器上:

# Clone repository
git clone https://github.com/jonasradke-dev/gas-price-mcp.git
cd gas-price-mcp

# Create .env file
echo "TANKERKOENIG_API_KEY=your_api_key_here" > .env

# Start the service
docker compose up -d

# View logs
docker compose logs -f

# Stop the service
docker compose down

对于波德曼:

podman compose up -d

更新应用程序:

git pull
docker compose up -d --build

Docker(手册)

构建并运行:

docker build -t gas-price-mcp .
docker run -d \
  --name gas-price-mcp \
  --restart unless-stopped \
  -p 8000:8000 \
  -e TANKERKOENIG_API_KEY=your_api_key \
  gas-price-mcp

API学分

  • 地理编码: OpenStreetMap提名
  • 天然气价格: Tankerkoenig(创作共享)