osm-mcp

OpenStreetMap向けのMCPサーバーです。ジオコーディング、徒歩・車・自転車の距離と所要時間、複数経由地のルート最適化、等時線、POI検索を提供し、AIアシスタントによる旅行計画のために構築されています。

11のツールを提供し、すべて読み取り専用です。すべてのバックエンドは無料の公開OpenStreetMapサービスであり、APIキーは不要です。オプションでOpenRouteServiceのキーを指定すると、ルーティングエンジンを切り替えることができます。

📖 完全なドキュメント: https://osm-mcp.ni-c.de

なぜ別のOSM MCPサーバーなのか？

• 正しい徒歩・自転車ルート。 公開OSRMデモサーバーはOSRM URLパス内のプロファイルセグメントを無視し、FOSSGISの routed-foot / routed-bike / routed-car パスプレフィックスが使用されない限り、常に車のルートを返します。既存のほとんどのOSM MCPサーバーはこれを誤って処理し、徒歩クエリに対して黙って車の所要時間を返します。このサーバーは正しいプレフィックスを使用し、ライブスモークテストで徒歩ルートが車ルートよりもはるかに遅いことを確認しています。

• ポリシー準拠の設計。 サービスごとのレート制限（NominatimとOSRM: 1リクエスト/秒）、すべてのリクエストに識別用のUser-Agent（Nominatim利用ポリシーで必須）、レスポンスキャッシュ、Overpassの同時実行数制限（2スロット）、429/5xxエラー時のOverpassミラーへの自動フェイルオーバーを備えています。

• Photonサポート。 komootのPhotonによるオプションのタイポ耐性ジオコーディング。インタラクティブな使用向けに設計されており、Nominatimを連打するよりもLLM駆動のルックアップに適しています。

Related MCP server: Geo MCP Worker

要件

• Node.js ≥ 22

• 公開OpenStreetMapサービスへのインターネットアクセス（下記の表を参照）

設定

すべての変数はオプションです。サーバーはそのまま動作します。

インストール

claude mcp add osm -- npx -y osm-mcp

Claude Desktop (claude_desktop_config.json):

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

Codex (~/.codex/config.toml):

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

コンテナ（マルチアーキテクチャ、SBOMとビルド証明書付き）:

docker run -i --rm ghcr.io/ni-c/osm-mcp

-i は必須です。プロトコルは標準入力と標準出力で動作します。公開するポートはありません。その他のクライアント設定方法はクライアントガイドにあります。

ツール

すべての場所入力は、名前/住所（自動ジオコーディング）またはリテラル座標 "lat,lon" のいずれかを受け付けます。

利用ポリシーと帰属表示

このサーバーは共有コミュニティインフラと通信します。公開されている制限をクライアント側で強制しますが、運営者は全体的な使用を軽度かつ非商業的に抑えるようユーザーに求めています。

• データ: © OpenStreetMap コントリビューター、ODbL 1.0 に基づきライセンス。

• Nominatim: 最大1リクエスト/秒、識別用User-Agent必須、結果はキャッシュされます（ポリシー）。

• OSRM / Valhalla (FOSSGIS): 妥当かつ非商業的な使用。最大1リクエスト/秒（詳細）。

• Overpass: IPあたり約2同時スロット、10,000クエリ/日未満（wiki）。

• Photon: フェアユース（photon.komoot.io）。

大量または商業的な使用の場合は、サービスをセルフホストし、*_BASE_URL 変数で自身のインスタンスを指定してください。

安全性

• すべてのツールは読み取り専用です。サーバーがOpenStreetMapに書き込むことはありません。

• 認証情報は不要です。オプションの ORS_API_KEY は読み込み後にプロセス環境から削除され、エラーメッセージからも編集されます。

• OSM由来のコンテンツ（名前、住所、タグ）はツール結果内で信頼できないデータとしてマークされ、モデルがデータとして扱い、指示として扱わないようにします。

• アップストリームのエラー本文は切り詰められ、HTMLエラーページはモデルコンテキストに到達する前に削除されます。

• リダイレクトは決して追跡されません。すべてのリクエストはタイムアウトします。

開発

npm install
npm run lint          # eslint + prettier
npm test              # unit tests (all upstream APIs mocked)
npm run test:coverage
npm run build
npm run smoke         # opt-in LIVE test against the real public services

リリース

タグ駆動型で、手動の公開手順は不要です。

1. CHANGELOG.md の [Unreleased] エントリを新しい ## [x.y.z] - YYYY-MM-DD セクションに移動し、package.json のバージョンを更新します。

2. npm run lint && npm run build && npm run test:coverage を実行します。

3. コミット後、署名付き注釈付きタグを作成します: git tag -s vx.y.z -m "vx.y.z"。

4. git push origin main vx.y.z を実行します。

その後、release.yml がテストを実行し、Trusted Publishing（トークンシークレット不要）を介してnpmに公開し、CHANGELOGセクションからGitHubリリースを作成し、MCPレジストリに io.github.ni-c/osm-mcp として公開します。ci.yml は同じタグでマルチアーキテクチャイメージをGHCRにプッシュします。

レジストリのステップが失敗した場合は、main ブランチで修正し、Publish to MCP Registry ワークフローを手動で起動してください。タグジョブを再実行しないでください。古いツリーをチェックアウトすることになります。

ライセンス

MIT