Map Canvas MCP

用于 MCP Apps 宿主（如 ChatGPT）的嵌入式交互式地图。Worker 返回地图数据以及稳定的 UI 加载器。每个工具结果都会选择从 Cloudflare Static Assets 提供的内容寻址 Leaflet 包，因此 UI 更新无需刷新未更改的工具元数据。用户的浏览器直接从标准瓦片服务器获取可见的 OpenStreetMap 瓦片。

生产端点

https://map-canvas.android-mxdiego9.workers.dev/mcp

该端点是公开的，不需要身份验证。

Related MCP server: Mapbox MCP Server

本地开发

npm install
npm run check
npm run dev

npm run check 对 Worker 进行类型检查，并运行 MCP 冒烟测试，涵盖初始化、工具发现、工具执行和 widget 资源加载。

本地 MCP 端点为 http://localhost:8787/mcp。使用 MCP Inspector 进行测试：

npx @modelcontextprotocol/inspector@latest

部署

从终端部署：

npm run deploy

不需要 API 密钥。不要将机密添加到源代码或 wrangler.jsonc 中；如果以后添加身份验证，请使用 Cloudflare 机密。

使用 GitHub Actions 部署

随附的工作流会在每次推送到 main 时部署，然后针对公共端点运行生产环境 MCP 冒烟测试。也可以从 Actions 标签页手动运行。首先添加以下仓库 Actions 机密：

• CLOUDFLARE_API_TOKEN：一个范围限定为编辑目标账户中 Workers 的令牌

• CLOUDFLARE_ACCOUNT_ID：目标 Cloudflare 账户 ID

这些值保存在 GitHub Actions 机密中，不得提交到仓库。

工具

show_map 接受 1–50 个带有十进制纬度/经度坐标的地点。简单的调用者仍可使用 connectPlaces；旅行行程还可以添加：

• 日/日期和时间标签，支持按天筛选

• 类别以及已确认/已计划/暂定状态

• 步行、汽车、出租车、公交、铁路、渡轮和航班的交通路段

• 示意性直线连接或实际路线几何

• 已验证的地点链接，并使用 Google Maps 坐标链接作为回退

该 widget 使用按类别着色的编号标记、行程面板、重置视图操作，以及 ChatGPT 中可选的全屏演示。示意性路段使用虚线并明确标注，以免被误认为是逐向导航。

地图数据 © OpenStreetMap 贡献者。