Pumperly Mcp

pumperly-mcp

任意のPumperlyインスタンスをMCP サーバーとして公開する小さなブリッジです。AI エージェントは約40か国（主にヨーロッパ）で、ある場所の近くやドライブの経路上にある最安の燃料補給所や充電スポットを探せます。

機能

• 読み取り専用ツールが6つあります。

  ツール	回答する内容
  cheapest_fuel_on_route	2つの場所の間で給油できる場所を、1回の呼び出しで検索します
  find_nearest_stations	場所の名前または座標の近くにあるステーションを、距離または価格順に検索します
  get_stations_in_area	指定した範囲内のステーションを、価格の安い順に検索します
  calculate_route	最大5か所の経由地を含む、場所間の走行距離と所要時間を計算します
  find_route_stations	すでに取得しているルート形状に沿ったステーションを検索します
  geocode	場所の名前から座標を取得します

• リソースが4つあります：pumperly://fuel-types、pumperly://config、pumperly://stats、pumperly://exchange-rates。

• 簡潔な回答：ステーション一覧は並べ替えられ、指定した上限件数に絞られたうえで要約（最低、中央値、最高価格）されるため、検索に必要なコンテキストは約1 KBです。

• 同じバイナリでMCP 2026-07-28と、2024-11-05までのすべての旧バージョンに対応しています。新しいクライアントはserver/discoverを、旧バージョンはinitializeを使用します。

• トランスポートは2種類あります：stdio、およびベアラートークンとオリジンチェックを備えた/mcp上のストリーム可能なHTTP。

• pumperly.comの公開インスタンスでも、独自のインスタンスでも使用できます：PUMPERLY_URLを設定してください。APIキーは不要です。

すべてのツールは読み取りのみを行うため、読み取り専用の切り替え設定は不要です。

インストール

npmパッケージは、プラットフォームに対応するリリースバイナリをダウンロードし、パッケージに同梱されたチェックサムを使ってSHA-256を検証したうえで、stdio経由で実行します。Node.js 18以降が必要です。

Claude Code：

claude mcp add pumperly -- npx -y pumperly-mcp

Claude Desktop（claude_desktop_config.json）およびCursor（~/.cursor/mcp.json）：

{
  "mcpServers": {
    "pumperly": { "command": "npx", "args": ["-y", "pumperly-mcp"] }
  }
}

VS Code（.vscode/mcp.json）：

{
  "servers": {
    "pumperly": { "type": "stdio", "command": "npx", "args": ["-y", "pumperly-mcp"] }
  }
}

Codex（~/.codex/config.toml）：

[mcp_servers.pumperly]
command = "npx"
args = ["-y", "pumperly-mcp"]

Docker（stdio経由）：

docker run -i --rm -e TRANSPORT=stdio drumsergio/pumperly-mcp:v0.2.0

独自のPumperlyインスタンスを使用するには、環境変数にPUMPERLY_URLを追加してください（JSON設定では"env": { "PUMPERLY_URL": "https://..." }）。HTTPトランスポートについては、はじめにを参照してください。

ドキュメント

• はじめに：npm、Docker Compose、ソースからのビルド、クライアントの接続
• 設定：環境変数
• 使い方：ツール、リソース、リクエストの流れ、Inspectorを使ったテスト
• 関連プロジェクト：Pumperlyファミリー、その他のMCP サーバー、レジストリ掲載情報

ライセンス

GPL-3.0-or-later