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（创作共享）