Pumperly-MCP
A tiny bridge that exposes any Pumperly instance as an MCP server, enabling LLMs to query real-time fuel prices, find stations, plan routes, and geocode locations.
______________________________________________________________________
你得到了什么
| 类型 | 用途 | MCP URI/工具id |
|---|---|---|
| 资源 | 以只读方式浏览配置、统计数据和汇率 | pumperly://config |
pumperly://stats pumperly://exchange-rates | | 工具 |查找车站、计算路线并对位置进行地理编码| find_nearest_stations get_stations_in_area calculate_route find_route_stations geocode |
所有内容都通过单个JSON-RPC端点公开(/mcp). LLM/代理人可以： initialize -> readResource -> listTools -> callTool …等等。
______________________________________________________________________
快速入门（Docker Compose）
services:
pumperly-mcp:
image: drumsergio/pumperly-mcp:latest
ports:
- "127.0.0.1:8080:8080"
environment:
- PUMPERLY_URL=https://pumperly.com安全说明： HTTP传输侦听 127.0.0.1:8080 默认情况下。如果需要在网络上公开它，请将其放置在具有身份验证的反向代理后面。通过npm安装（stdio传输）
npx pumperly-mcp或全局安装：
npm install -g pumperly-mcp
pumperly-mcp这将从GitHub Release为您的平台下载预构建的Go二进制文件，并使用stdio传输运行它。至少需要一个 出版发行.
本地建设
git clone https://github.com/GeiserX/pumperly-mcp
cd pumperly-mcp
# (optional) create .env from the sample
cp .env.example .env && $EDITOR .env
go run ./cmd/server配置
| 变量 | 默认值 | 描述 |
|---|---|---|
PUMPERLY_URL | https://pumperly.com | Pumperly实例URL（不带尾随/） |
LISTEN_ADDR | 127.0.0.1:8080 | HTTP监听地址（Docker设置 0.0.0.0:8080) |
TRANSPORT | _（空=HTTP）_ | 设置为 stdio 用于stdio传输 |
把它们放在一个 .env 文件（来自 .env.example)或者将它们置于环境中。
测试
经过测试 检查员 目前，它正在全面运作。在进行PR之前，请确保此MCP服务器通过此介质运行良好。
客户端LLM的示例配置
{
"schema_version": "v1",
"name_for_human": "Pumperly-MCP",
"name_for_model": "pumperly_mcp",
"description_for_human": "Query real-time fuel prices, find stations, plan routes, and geocode locations via Pumperly.",
"description_for_model": "Interact with a Pumperly instance that aggregates fuel station data. First call initialize, then reuse the returned session id in header \"Mcp-Session-Id\" for every other call. Use readResource to fetch URIs that begin with pumperly://. Use listTools to discover available actions and callTool to execute them.",
"auth": { "type": "none" },
"api": {
"type": "jsonrpc-mcp",
"url": "http://localhost:8080/mcp",
"init_method": "initialize",
"session_header": "Mcp-Session-Id"
},
"logo_url": "",
"contact_email": "acsdesk@protonmail.com",
"legal_info_url": "https://github.com/GeiserX/pumperly-mcp/blob/main/LICENSE"
}学分
南瓜 --实时燃料价格汇总
MCP-GO --现代MCP实施
GoRelease --无痛多弓松解术
维护者
@盖泽尔.
贡献
尽情潜水吧！ 打开一个问题 或提交PR。
Pumperly MCP遵循 贡献者契约 行为准则。
GeiserX的其他MCP服务器
- 现金飞行员mcp --被动收入监测
- 重复 --备份健康监控
- 生殖细胞mcp --TR-069设备管理
- lynxprompt-mcp --AI配置蓝图
- 电报档案mcp --电报消息存档