overpass.ch

overpass.ch MCP サーバー

MCP サーバーを備えたホスト型 Overpass API です。接続した AI アシスタントは、地球全体の OpenStreetMap データを検索し、名前から場所を探し、高度を調べ、最新データに基づいて回答できます。

データは、OpenStreetMap に登録されたすべての道路、店舗、建物、場所を網羅しており、毎分更新されます。Medium プランと Large プランでは、2012 年 9 月までさかのぼって、過去の日付の地図を検索することもできます。

このリポジトリには、https://api.overpass.ch/v1/mcp にあるホスト型サーバーのドキュメントとレジストリエントリーが含まれています。インストールは不要です。

• ウェブサイト： https://overpass.ch
• セットアップガイド： https://overpass.ch/guides/overpass-mcp-server
• ドキュメント： https://overpass.ch/docs#mcp
• 公式 MCP レジストリ： ch.overpass/overpass

セットアップ

1. https://overpass.ch/signup で無料アカウントを作成し、API キーを取得します。

2. キーを含む URL として、または次のようにして、サーバーをアシスタントに追加します。

   https://api.overpass.ch/v1/YOUR_API_KEY/mcp
   

   あるいは、X-API-Key ヘッダー（または Authorization: Bearer YOUR_API_KEY）にキーを指定して、https://api.overpass.ch/v1/mcp を設定します。

トランスポート：Streamable HTTP。プロトコルバージョンは 2026-07-28 および 2025-03-26 から 2025-11-25 までです。ツールの一覧表示にキーは必要ありません。キーを個別に取り消せるよう、アシスタントごとに別のキーを作成してください。

Claude（ウェブ、デスクトップ、モバイルアプリ）

Customize → Connectors → + Add → Add custom connector を選択します。名前：overpass.ch。URL：キーを含む URL。認証：No sign in。

ChatGPT

https://chatgpt.com/plugins を開き、+ を選択して Add custom MCP server を選びます。名前を入力し、Connection にキーを含む URL を入力して、認証なしに設定します。警告を確認して Create as a plugin を選択します。お使いの ChatGPT プランまたはワークスペースで、カスタム MCP サーバーが許可されている必要があります。

Claude Code

claude mcp add --transport http overpass https://api.overpass.ch/v1/mcp \
  --header "X-API-Key: YOUR_API_KEY"

Cursor

キーを環境変数 OVERPASS_KEY に設定したうえで、~/.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "overpass": {
      "url": "https://api.overpass.ch/v1/mcp",
      "headers": { "X-API-Key": "${env:OVERPASS_KEY}" }
    }
  }
}

VS Code

.vscode/mcp.json に追加します。VS Code は初回にキーを確認し、保存します。

{
  "inputs": [
    { "type": "promptString", "id": "overpass-key", "description": "overpass.ch API key", "password": true }
  ],
  "servers": {
    "overpass": {
      "type": "http",
      "url": "https://api.overpass.ch/v1/mcp",
      "headers": { "X-API-Key": "${input:overpass-key}" }
    }
  }
}

その他のクライアント

Streamable HTTP 経由で MCP を使用するその他のクライアントでは、キーを含む URL、またはキーなしの URL と X-API-Key ヘッダーを使用します。

エージェントプラグインとして使用する

このリポジトリはエージェントプラグインでもあります。plugin.json と mcp.json によって、https://api.overpass.ch/v1/mcp にあるサーバー overpass が追加されます。プラグインにキーを含めることはできないため、クライアントの設定でサーバー overpass にキーを指定した X-API-Key ヘッダーを追加してください。キーがない場合、ツールの一覧は表示されますが、呼び出しのたびにキーが不足しているという応答が返されます。

ツール

ツール	機能	使用数のカウント
overpass_query	地球全体を対象に、Overpass QL または XML クエリを実行します。回答の先頭には件数とデータの日付が表示され、その後に要素が1行ずつ表示されます。30,000文字を超える回答は切り詰められますが、offset を使って分割して読み取れます。	1リクエスト
overpass_examples	99件のクエリを収録したクックブックから、トピックに合ったテスト済みのクエリ例を探します。	無料
geocode_search	英語、ドイツ語、フランス語で、名前から場所、住所、関心地点を検索します。検索した場所の内側を対象に検索するための overpass_area_id も返します。	1回のジオコーディングリクエスト
geocode_reverse	指定した地点の住所、通り、市区町村、国を特定します。	1回のジオコーディングリクエスト
elevation_points	地点の標高を取得します。スイスとリヒテンシュタインでは2 mグリッド（swissALTI3D）、陸地のその他の地域では30 mグリッド（Copernicus）、海では水深（GEBCO）を使用します。	地点ごとに1回の検索
elevation_profile	経路に沿った距離、上り、下り、高度を取得します。	サンプルごとに1回の検索
account_status	プラン、今月の使用量、データの日付を表示します。	無料

すべてのツールはデータの読み取りのみを行います。MCP 経由の Overpass クエリは、最長で120秒後に停止します。

質問例

• チューリッヒで、トラムの停留所から200 m以内にある薬局はいくつですか？
• ヴァレー州で、標高2,500 mを超える山小屋はどれですか？
• ベルン州にあるすべてのEV充電器を、運営者と出力を含めて表にしてください。
• ローザンヌのカフェは2015年にいくつあり、現在はいくつありますか？（MediumプランおよびLargeプラン）

プラン

ツール呼び出しは、REST APIの同じ呼び出しとしてカウントされます。

プラン	月額料金	月間Overpassリクエスト数	同時実行クエリ数	履歴
Free	0	10,000（1分あたり30）	1	なし
Small	CHF/EUR 19またはUSD 25	100,000	2	なし
Medium	CHF/EUR 59またはUSD 79	1 million	6	あり
Large	CHF/EUR 149またはUSD 199	3 million	10	あり

Freeプランは、評価や開発、個人、教育、非営利のプロジェクト向けです。商用利用には有料プランが必要です。すべてのプランに、月間100,000件のジオコーディングリクエストが含まれます。料金にVATは含まれておらず、年間料金は10か月分です。詳細：https://overpass.ch/pricing

FAQ

APIキーは必要ですか？ はい、ツール呼び出しには必要です。Freeプランを利用できます。ツールの一覧表示にはキーは必要ありません。

結果が非常に大きい場合はどうなりますか？ 回答には要素の件数が表示されます。アシスタントはoffsetを使って次の部分を読み取るか、max_charsを最大200,000まで増やすか、クエリを絞り込むことができます（out count;、out center 50;、より小さいエリアなど）。

overpass-api.deを使用するMCPサーバーとは何が違いますか？ 公開サーバーのoverpass-api.deでは、定期的に実行されるクエリは1日あたり約100件までです。独自のUser-Agentを設定していないスクリプトは拒否され、429エラーが繰り返されるとアドレスがブロックされます。overpass.chではAPIキーで利用者を識別し、制限を公開するとともに、制限に達した際にどれくらい待てばよいかをアシスタントに伝えます。

何がログに記録されますか？ ツール呼び出しはAPIリクエストと同様に記録されます。記録されるのはキーのIDで、キー自体は記録されません。また、クエリはハッシュとしてのみ記録されます。

データとライセンス

データ © OpenStreetMap contributors。Open Database Licence（https://www.openstreetmap.org/copyright）のもとで利用できます。スイスおよびリヒテンシュタインの標高データ © swisstopo。overpass.chはスイスで運営されており、サーバーはフィンランド（EU）にあります。お問い合わせ：https://overpass.ch/contact