Apple Maps

io.github.JonathanRReed由 GitHub 帳號 JonathanRReed 發布v1.1.6更新於 Nov 7, 2026

Search places, estimate routes, and build Apple Maps links on macOS.

已驗證STDIO僅桌面位置與生活效率與工作流

概覽

AI 產生的概覽

本機 macOS MCP 伺服器，讓助理搜尋 Apple 地圖地點、估算路線、產生地圖連結並在地圖 App 中開啟導航。

可以做什麼
  • 在 Apple 地圖中搜尋符合的地點
  • 取得起點與終點之間的路線詳情、距離與行車時間
  • 為目的地或路線產生 Apple 地圖連結，並在地圖 App 中開啟導航
  • 檢查伺服器健康狀態，並取得 macOS 本機輔助程式的權限說明
  • 透過 search_tools 與 get_tool_info 探索並載入工具結構，另提供提示詞備援工具
適用情境
適合在 Mac 上需要地點查詢、行程時間估算或地圖連結的情況，例如交通或路線會影響行事曆、提醒事項、訊息或郵件操作時。README 建議在寫入對時間敏感的計畫前，先確認起點、終點與交通方式。
執行需求
僅在 macOS 上以本機方式執行，預設使用 stdio 傳輸。需要 uv（以 uvx apple-maps-mcp 從 PyPI 執行）或複製儲存庫並使用 Python 3.11 以上版本；會編譯本機 Swift 輔助程式，可能需要 Xcode 命令列工具。未宣告任何帳號、API 金鑰或環境變數。可透過 APPLE_MAPS_MCP_TRANSPORT 改用 Streamable HTTP。
安裝前請注意
它會在地圖 App 中開啟導航，因而改變使用者電腦上的顯示內容。本機輔助程式必須編譯成功，失敗時需安裝 Xcode 命令列工具。地點搜尋與路線資訊會傳送至 Apple 地圖服務。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Apple Maps，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

Apple Maps MCP

Local MCP server for Apple Maps search and routing on macOS.

Capabilities

  • search for places
  • estimate route distance and travel time
  • build Apple Maps links
  • open directions in Apple Maps
  • resource: maps://status
  • prompt: maps_plan_route
  • tool discovery helpers search_tools and get_tool_info for context-constrained clients

Install On This Mac

Quick start (uvx, from PyPI)

With uv installed:

bash
uvx apple-maps-mcp

No clone, no venv management.

From a clone
bash
git clone https://github.com/JonathanRReed/Apple-MCPs.gitcd Apple-MCPsuv sync --all-packages

This builds one workspace environment with every server's entry point in .venv/bin (for example .venv/bin/apple-maps-mcp). You can also point an MCP client at AppleMaps-MCP/start.sh, which prefers uv run and falls back to a plain venv bootstrap (Python 3.11+ required).

Install In AI Agents

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

Running from a clone instead? Use /path/to/Apple-MCPs/AppleMaps-MCP/start.sh as the command with empty args.

Claude Code:

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

--scope user makes the server available in every project. To share it with one repository through its .mcp.json instead, use --scope project.

Transport

stdio is the default and recommended transport. Set APPLE_MAPS_MCP_TRANSPORT=streamable-http (with optional APPLE_MAPS_MCP_HOST and APPLE_MAPS_MCP_PORT) to serve Streamable HTTP instead.

Prompting Notes

  • tools/list returns the full Maps tool surface. Context-constrained clients can use search_tools first, then get_tool_info for the Maps tool they need.
  • Use this server when travel, routing, or place lookup affects a Calendar, Reminders, Messages, or Mail action.
  • Confirm origin, destination, and transport mode before writing a time-sensitive plan.
  • If helper compilation fails, install Xcode command line tools and retry.

Health And Recovery

  • maps_health
  • maps_permission_guide

Launch Checklist

  • Add uvx apple-maps-mcp (or a clone's AppleMaps-MCP/start.sh) to your MCP client
  • Reload or reconnect the client so the Maps tool surface is loaded into context
  • Call maps_health first
  • If the local helper or routing surface is blocked, call maps_permission_guide
  • Run maps_search_places once to confirm the local Swift helper compiles

來源：AppleMaps-MCP/README.md，提交 9aeaa81

工具

10

maps_health

Maps Health

Report the active Apple Maps MCP configuration.

無需輸入參數。

maps_permission_guide

Maps Permission Guide

Explain Apple Maps MCP local helper requirements on macOS.

無需輸入參數。

maps_search_places

Search Places

Search Apple Maps for matching places.

輸入參數limitquery必填

maps_get_directions

Get Directions

Get Apple Maps route details between an origin and destination.

輸入參數origin必填transportdestination必填

maps_open_directions_in_maps

Open Directions In Maps

Open directions in the Apple Maps app.

輸入參數origintransportdestination必填

maps_list_prompts

Maps List Prompts

Fallback prompt discovery tool for tool-only MCP clients.

無需輸入參數。

maps_get_prompt

Maps Get Prompt

Fallback prompt rendering tool for tool-only MCP clients.

輸入參數name必填arguments_json

search_tools

Search Tools

Search this server's tool catalog by keyword, alias, or domain tag.

輸入參數modelimitquery必填domain_tags

get_tool_info

Get Tool Info

Load the full schema, examples, and metadata for one tool from this server.

輸入參數name必填include_schemainclude_examples

版本歷史

8
  1. v1.1.6最新Nov 6, 2026
  2. v1.1.4Oct 29, 2026
  3. v1.1.3Oct 22, 2026
  4. v1.1.2Oct 14, 2026
  5. v1.1.1Oct 13, 2026
  6. v1.1.0Oct 10, 2026
  7. v1.0.5Sep 26, 2026
  8. v1.0.4Sep 16, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分
  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分