TankoUp

TankoUp MCP 服务

向 Claude、ChatGPT 或任何 MCP 客户端询问在西班牙哪里加油更便宜。

这是 TankoUp 的 Model Context Protocol 服务。TankoUp 是一款用于查找西班牙最便宜加油站的应用，覆盖约 12,000 个加油站：西班牙本土、巴利阿里群岛和加那利群岛、休达和梅利利亚。价格来自西班牙政府的开放数据（MITECO），每 4 小时刷新一次。

• 端点： https://mcp.tankoup.com/mcp（Streamable HTTP）
• 身份验证： 无。数据是公开的，工具只读取数据。

“卢塞纳附近哪里有最便宜的柴油？” “我明天要从马德里开车去瓦伦西亚。95 号汽油应该在哪里加？” “比斯开省的汽油价格与西班牙其他地区相比如何？”

工具

工具	可回答的问题
find_cheapest_fuel_nearby	某个城镇、城市或地点附近，某种燃油价格最划算的加油站
find_cheapest_fuel_on_route	最长 1,200 km 的行车路线沿途，价格最划算的加油站
get_province_fuel_prices	某省的平均价格和最低价格、30 天价格趋势、与西班牙整体价格的比较，以及该省价格最低的加油站
get_station_details	某个加油站所有燃油的价格、营业时间、地址和链接

燃油类型：diesel（Gasóleo A）、diesel_premium、sp95（Gasolina 95 E5）、sp95_e10、sp98 和 lpg（GLP）。

加油站按总成本排名，而非仅按油泵价格排名：计算加满 40 L 燃油的价格，加上开车往返的耗油成本（或驶离路线再返回路线的耗油成本）。通常，便宜 2 分但距离远 15 km 的加油站并不划算。

西班牙城镇和城市可按名称搜索（“Lucena, Córdoba”“San Sebastián”“Palma”），系统会在所有设有加油站的市镇中查找。对于街道、地标或用户所在位置，客户端会传入纬度和经度。

每条回答都简短且结构清晰：列出几家加油站，以及各自的价格、距离、当前是否营业、用于在 TankoUp 中打开的链接和 Google 地图路线链接。每条回答还附带 TankoUp 应用的 App Store 和 Google Play 链接。

连接

Claude（claude.ai 和 Desktop；之后也可在移动设备上使用）：依次选择 Customize → Connectors → Add → Add custom connector，然后粘贴 https://mcp.tankoup.com/mcp。

ChatGPT（任何方案，包括 Free）：依次选择 Plugins → Add → Add custom MCP server，粘贴上面的 URL，并选择“No authentication”。然后在聊天中提及 @TankoUp。

Claude Code：

claude mcp add --transport http tankoup https://mcp.tankoup.com/mcp

任何其他支持 Streamable HTTP 的客户端：将其指向 https://mcp.tankoup.com/mcp。

工作原理

Claude / ChatGPT ──MCP──▶ tankoup-mcp (Cloud Run) ──HTTPS──▶ TankoUp API ──▶ Postgres
                                                     (the API the app and website use,
                                                      fed from MITECO every 4 hours)

• 使用 Python 和官方 MCP Python SDK（v2），通过 Streamable HTTP 以无状态模式提供服务，并返回 JSON 响应，因此任何实例都可以回答任何请求。
• 服务端不存储任何数据。每个价格都来自为 TankoUp 应用和网站提供数据的同一 API；服务端不会访问数据库或政府数据源。
• 地名通过包含所有设有加油站的西班牙市镇的地名数据库离线解析（src/tankoup_mcp/data/places.json，由 scripts/build_places.py 根据 API 构建）。不使用地理编码服务或第三方服务。
• 回答会在内存中缓存 10 分钟。
• 限制：每个客户端 IP 每分钟 120 个请求，每个实例每分钟 600 个请求，最多运行一个实例，每天最多进行 100 次路线搜索。
• 服务运行在 Google Cloud Run 的 europe-west1（比利时）区域，空闲时缩容至零。

隐私

服务器不会记录你询问的内容。每次工具调用只记录一行，包括工具名称、协议版本和耗时；绝不记录参数、地点或坐标。与任何 Web 服务一样，它会看到调用者的 IP 地址；对于 Claude 和 ChatGPT，看到的是平台的 IP 地址，而不是你的 IP 地址；Google Cloud 的请求日志会保留这些信息 30 天。指向 tankoup.com 和应用商店的链接带有 utm_source=mcp，因此 TankoUp 自己的分析工具可以统计通过助手产生的访问和安装；对话中的任何信息都不会随链接传过去。不会与任何人共享任何信息。TankoUp 的隐私政策：https://tankoup.com/en/legal/privacy-policy。

自行运行

需要 Python 3.12+ 和 uv。

uv sync
TANKOUP_API_KEY=... uv run uvicorn tankoup_mcp.app:app --port 8000

然后通过 http://localhost:8000/mcp 启动 MCP Inspector：

npx @modelcontextprotocol/inspector

变量	默认值
TANKOUP_API_KEY	—	TankoUp API 的密钥
TANKOUP_API_URL	https://api.tankoup.com
CACHE_TTL_S	600	答案的缓存时长
RATE_LIMIT_PER_IP	120	每个客户端 IP 每分钟对 /mcp 的请求数
RATE_LIMIT_GLOBAL	600	每个实例每分钟对 /mcp 的请求数
ROUTE_DAILY_LIMIT	100	每个实例每天的路线搜索次数
ALLOWED_HOSTS	empty	主机允许列表；为空时会关闭 DNS 重绑定防护，这适用于 Cloud Run 后方

测试

uv run pytest

每个工具都会使用模拟 API 进行测试，模拟 API 具有真实的响应结构；此外还会测试 HTTP 层：旧版客户端的握手和工具调用、速率限制、CORS 和健康检查。

对于正在运行的服务器，scripts/smoke.py 会对每个工具调用一次：

uv run python scripts/smoke.py https://mcp.tankoup.com/mcp

部署

scripts/setup-gcp.sh   # once: the API key in Secret Manager and a service account
scripts/deploy.sh      # build in Cloud Build and deploy to Cloud Run

许可证

MIT。燃油价格数据：西班牙生态转型与人口挑战部（MITECO）提供的开放数据。