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 地图地点、估算路线、生成地图链接并在地图应用中打开导航。

可以做什么
  • 在 Apple 地图中搜索匹配的地点
  • 获取起点与终点之间的路线详情、距离和行程时间
  • 为目的地或路线生成 Apple 地图链接，并在地图应用中打开导航
  • 检查服务器健康状态，并获取 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。
安装前请注意
它会在 Apple 地图应用中打开导航，从而改变用户机器上的显示内容。本地辅助程序必须编译成功，失败时需安装 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 分