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 Agent 中安装

{
  "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 仅与一个仓库共享，请使用 --scope project。

传输方式

默认且推荐的传输方式是 stdio。设置 APPLE_MAPS_MCP_TRANSPORT=streamable-http（可选设置 APPLE_MAPS_MCP_HOST 和 APPLE_MAPS_MCP_PORT）即可改用 Streamable HTTP 提供服务。

提示词说明

• tools/list 会返回完整的 Maps 工具集。上下文受限的客户端可以先使用 search_tools，再通过 get_tool_info 获取所需的 Maps 工具信息。
• 当出行、路线规划或地点查询会影响 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 辅助工具可以编译