使用说明
产品定位
TomTom MCP 服务器是一个地理空间开发工具，提供对 TomTom 位置服务的无缝访问，包括搜索、路线规划、交通和静态地图数据。
核心功能
- 地理编码：将地址转换为坐标，提供全球覆盖。
- 反向地理编码：根据 GPS 坐标获取地址。
- 模糊搜索：智能搜索，支持容错（拼写错误）。
- 兴趣点搜索：查找特定的商业类别（兴趣点）。
- 附近搜索：发现指定半径内的服务。
- 路线规划：计算位置之间的最优路线。
- 多站点路线规划：多站点路线规划。
- 可达范围：根据时间/距离确定覆盖范围区域。
- 交通数据：实时交通事件数据。
- 静态地图：生成自定义地图图像。
适用场景
- AI 工作流中的地理位置数据集成。
- 开发环境中的地理空间功能实现。
- 实时交通和路线规划应用。
- 兴趣点和附近服务搜索应用。
使用教程
使用依赖
- Node.js 22 或更高版本
- TomTom API 密钥
安装教程
# 安装到本地项目
npm install @tomtom-org/tomtom-mcp@latest
# 或者直接运行而无需安装
npx @tomtom-org/tomtom-mcp@latest
配置
# 选项 1：使用 .env 文件（推荐）
echo "TOMTOM_API_KEY=你的_api_密钥" > .env
# 选项 2：环境变量 (Linux/macOS)
export TOMTOM_API_KEY=你的_api_密钥
# Windows CMD: set TOMTOM_API_KEY=你的_api_密钥
# Windows PowerShell: $env:TOMTOM_API_KEY="你的_api_密钥"
# 选项 3：作为 CLI 参数传递
npx @tomtom-org/tomtom-mcp@latest --key 你的_api_密钥
调试方式
# 启动 MCP 服务器
npx @tomtom-org/tomtom-mcp@latest
# 获取帮助
npx @tomtom-org/tomtom-mcp@latest --help
