Apple Maps

Apple Maps MCP

macOS 上で Apple Maps の検索やルート検索を行うローカル MCP サーバーです。

機能

• 場所を検索する
• ルートの距離と所要時間を見積もる
• Apple Maps のリンクを作成する
• Apple Maps で経路を開く
• リソース：maps://status
• プロンプト：maps_plan_route
• コンテキストに制約のあるクライアント向けのツール検出ヘルパー search_tools および get_tool_info

この Mac にインストールする

uvx apple-maps-mcp

git clone https://github.com/JonathanRReed/Apple-MCPs.git
cd Apple-MCPs
uv sync --all-packages

AI エージェントにインストールする

{
  "mcpServers": {
    "apple-maps": {
      "command": "uvx",
      "args": ["apple-maps-mcp"],
      "env": {}
    }
  }
}

クローンから実行する場合は、コマンドに /path/to/Apple-MCPs/AppleMaps-MCP/start.sh を指定し、args は空にしてください。

Claude Code：

claude mcp add --transport stdio --scope user apple-maps -- uvx apple-maps-mcp

--scope user を指定すると、すべてのプロジェクトでサーバーを利用できます。代わりに .mcp.json を通じて1つのリポジトリで共有するには、--scope project を使用してください。

トランスポート

既定かつ推奨のトランスポートは stdio です。APPLE_MAPS_MCP_TRANSPORT=streamable-http（必要に応じて APPLE_MAPS_MCP_HOST と APPLE_MAPS_MCP_PORT も指定）を設定すると、代わりに Streamable HTTP で提供されます。

プロンプトのヒント

• tools/list は Maps の全ツールを返します。コンテキストに制約のあるクライアントでは、まず search_tools を使い、次に必要な Maps ツールについて get_tool_info を使えます。
• 旅行、ルート検索、または場所の検索が Calendar、Reminders、Messages、Mail の操作に影響する場合は、このサーバーを使用してください。
• 時間に関わる計画を作成する前に、出発地、目的地、移動手段を確認してください。
• ヘルパーのコンパイルに失敗する場合は、Xcode コマンドラインツールをインストールして再試行してください。

ヘルスチェックと復旧

• maps_health
• maps_permission_guide

起動チェックリスト

• uvx apple-maps-mcp（またはクローンの AppleMaps-MCP/start.sh）を MCP クライアントに追加します
• Maps ツールがコンテキストに読み込まれるよう、クライアントを再読み込みするか再接続します
• まず maps_health を呼び出します
• ローカルヘルパーまたはルート検索機能がブロックされている場合は、maps_permission_guide を呼び出します
• maps_search_places を一度実行し、ローカルの Swift ヘルパーがコンパイルされることを確認します