English Français العربية

Pumperly

السجل الرسمي الإنتاجية

Cheapest fuel and EV charging near a place or along a drive, in about 40 countries

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع Pumperly؟

  • Five tools: find_nearest_stations, get_stations_in_area, calculate_route, find_route_stations, geocode.
  • Three read-only resources: pumperly://config, pumperly://stats, pumperly://exchange-rates.
  • Two transports: stdio, and HTTP on a single /mcp endpoint.
  • An npm package that downloads the release binary for your platform and runs it over stdio.
  • A Docker image for amd64 and arm64.
  • Works with the public instance at pumperly.com or your own: set PUMPERLY_URL.
  • No API key: it reads the Pumperly API anonymously.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package pumperly-mcp
Claude Code 
claude mcp add pumperly -e 'PUMPERLY_URL=https://pumperly.com' -- npx -y pumperly-mcp@0.2.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "pumperly": {
            "command": "npx",
            "args": [
                "-y",
                "pumperly-mcp@0.2.0"
            ],
            "env": {
                "PUMPERLY_URL": "https://pumperly.com"
            }
        }
    }
}

متغيرات البيئة

  • PUMPERLY_URL Pumperly instance URL (default https://pumperly.com); set it to use your own instance
OCI package drumsergio/pumperly-mcp:v0.2.0
Claude Code 
claude mcp add pumperly -e 'PUMPERLY_URL=https://pumperly.com' -- docker run -i --rm drumsergio/pumperly-mcp:v0.2.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "pumperly": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "drumsergio/pumperly-mcp:v0.2.0"
            ],
            "env": {
                "PUMPERLY_URL": "https://pumperly.com"
            }
        }
    }
}

متغيرات البيئة

  • PUMPERLY_URL Pumperly instance URL (default https://pumperly.com); set it to use your own instance

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. pumperly-mcp
  2. Features
  3. Quick start
  4. Documentation
  5. License

pumperly-mcp

A small bridge that exposes any Pumperly instance as an MCP server, so an AI agent can query fuel prices, find stations, plan routes and geocode places.

Features

  • Five tools: find_nearest_stations, get_stations_in_area, calculate_route, find_route_stations, geocode.
  • Three read-only resources: pumperly://config, pumperly://stats, pumperly://exchange-rates.
  • Two transports: stdio, and HTTP on a single /mcp endpoint.
  • An npm package that downloads the release binary for your platform and runs it over stdio.
  • A Docker image for amd64 and arm64.
  • Works with the public instance at pumperly.com or your own: set PUMPERLY_URL.
  • No API key: it reads the Pumperly API anonymously.

Quick start

Add this to your MCP client's configuration (Claude Desktop, Claude Code, Cursor and others read the mcpServers format):

{
  "mcpServers": {
    "pumperly": {
      "command": "npx",
      "args": ["-y", "pumperly-mcp"],
      "env": { "PUMPERLY_URL": "https://pumperly.com" }
    }
  }
}

For the HTTP transport (/mcp on port 8080) run the Docker image; see Getting started.

Documentation

  • Getting started: npm, Docker Compose, building from source, connecting a client
  • Configuration: environment variables
  • Usage: tools, resources, the request flow, testing with the Inspector
  • Related projects: the Pumperly family, other MCP servers, registry listings

License

GPL-3.0-or-later

الأسئلة الشائعة

ما هو Pumperly؟

Cheapest fuel and EV charging near a place or along a drive, in about 40 countries

كيف أثبّت Pumperly؟

يعمل على جهازك. في Claude Code: claude mcp add pumperly -e 'PUMPERLY_URL=https://pumperly.com' -- npx -y pumperly-mcp@0.2.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Pumperly إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Pumperly مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص GPL-3.0.

من يصون Pumperly؟

ينشره GeiserX. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.