t

tomtom位置服务

NanaGo/tomtom-maps
Hosted
0 Stars 405 次浏览 更新于 2026-08-23

# TomTom开源的位置服务MCP TomTom的MCP（Map and Content Platform）是一个开源项目，旨在提供一系列位置相关的服务。该项目允许开发者利用TomTom的数据和服务来构建自己的应用程序。 ## 特性 - **地图渲染**：使用矢量瓦片技术，支持自定义样式。 - **搜索与地理编码**：快速准确地查找地址和地点。 - **路线规划**：提供多种交通方式下的最优路径计算。 - **实时交通信息**：获取最新的路况数据。 - **兴趣点**：访问全球数百万个POI（Points of Interest）。 ## 安装 要开始使用MCP，请按照以下步骤操作： 1. 克隆仓库到本地机器： bash git clone https://github.com/tomtom-international/mcp.git 2. 进入项目目录并安装依赖项： bash cd mcp npm install 3. 配置环境变量。请参考`.env.example`文件创建一个`.env`文件，并根据需要填写相关信息。 4. 启动服务： bash npm start ## 使用示例 ### 地图渲染 javascript import { Map } from '@tomtom-international/web-sdk-maps'; const map = new Map({ key: 'YOUR_API_KEY', container: 'map', style: 'https://api.tomtom.com/style/1/basic/main.json?apikey=YOUR_API_KEY' }); map.on('load', () => { console.log('Map loaded successfully.'); }); ### 搜索与地理编码 javascript import { Services } from '@tomtom-international/web-sdk-services'; Services.search({ key: 'YOUR_API_KEY', query: 'Eiffel Tower, Paris' }).then(response => { console.log(response); }); ### 路线规划 javascript import { Services } from '@tomtom-international/web-sdk-services'; Services.routes({ key: 'YOUR_API_KEY', origin: '52.5200,13.4050', destination: '52.5072,13.4050', travelMode: 'car' }).then(response => { console.log(response); }); 更多详细信息，请参阅[官方文档](https://developer.tomtom.com/)。 通过这些基本步骤，您可以轻松地将TomTom的地图和位置服务集成到您的应用中。希望这能帮助您快速上手！

位置服务

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "tomtom-maps": {
      "args": [
        "-y",
        "@tomtom-org/tomtom-mcp@latest"
      ],
      "command": "npx"
    }
  }
}

该服务需要配置环境变量：TOMTOM_API_KEY

可用工具 （10 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

tomtom-geocode 16 个参数 需填 1 项

必填参数：query

tomtom-reverse-geocode 24 个参数 需填 2 项

必填参数：lat、lon

tomtom-fuzzy-search 35 个参数 需填 1 项

必填参数：query

tomtom-poi-search 35 个参数 需填 1 项

必填参数：query

tomtom-nearby 31 个参数 需填 2 项

必填参数：lat、lon

tomtom-routing 49 个参数 需填 2 项

必填参数：origin、destination

tomtom-waypoint-routing 48 个参数 需填 1 项

必填参数：waypoints

tomtom-reachable-range 40 个参数 需填 1 项

必填参数：origin

tomtom-traffic 7 个参数

该工具无需必填参数，直接调用即可

tomtom-static-map 10 个参数 需填 1 项

必填参数：center

服务介绍

TomTom MCP 服务器

TomTom MCP Server 通过提供对 TomTom 位置服务的无缝访问，简化了地理空间开发。这些服务包括搜索、路线规划、交通和静态地图数据。它能够将精确的地理位置数据轻松集成到 AI 工作流和开发环境中。

快速开始

先决条件

  • Node.js 22 或更高版本
  • TomTom API 密钥

如何获取 TomTom API 密钥：

  1. 在 TomTom 开发者门户 上创建一个开发者帐户。
  2. 在左侧菜单中转到 API & SDK Keys。
  3. 点击 红色的 Create Key 按钮。
  4. 选择所有可用的 API 以确保完全访问权限，为您的密钥分配一个名称，然后点击 Create。

更多详细信息，请访问 TomTom API 密钥管理文档。

安装

bash

安装到本地项目

npm install @tomtom-org/tomtom-mcp@latest

或者直接运行而无需安装

npx @tomtom-org/tomtom-mcp@latest

配置

使用以下方法之一设置您的 TomTom API 密钥：

bash

选项 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_密钥

用法

bash

启动 MCP 服务器

npx @tomtom-org/tomtom-mcp@latest

获取帮助

npx @tomtom-org/tomtom-mcp@latest --help

集成指南

TomTom MCP Server 可以轻松集成到各种 AI 开发环境和工具中。

这些指南帮助您将 MCP 服务器与您的工具和环境集成：

可用工具

工具 描述 文档
tomtom-geocode 将地址转换为坐标，提供全球覆盖 https://developer.tomtom.com/geocoding-api/documentation/geocode
tomtom-reverse-geocode 根据 GPS 坐标获取地址 https://developer.tomtom.com/reverse-geocoding-api/documentation/reverse-geocode
tomtom-fuzzy-search 智能搜索，支持容错（拼写错误） https://developer.tomtom.com/search-api/documentation/search-service/fuzzy-search
tomtom-poi-search 查找特定的商业类别（兴趣点） https://developer.tomtom.com/search-api/documentation/search-service/points-of-interest-search
tomtom-nearby 发现指定半径内的服务 https://developer.tomtom.com/search-api/documentation/search-service/nearby-search
tomtom-routing 计算位置之间的最优路线 https://developer.tomtom.com/routing-api/documentation/tomtom-maps/calculate-route
tomtom-waypoint-routing 多站点路线规划 https://developer.tomtom.com/routing-api/documentation/tomtom-maps/calculate-route
tomtom-reachable-range 根据时间/距离确定覆盖范围区域 https://developer.tomtom.com/routing-api/documentation/tomtom-maps/calculate-reachable-range
tomtom-traffic 实时交通事件数据 https://developer.tomtom.com/traffic-api/documentation/traffic-incidents/traffic-incidents-service

贡献与本地开发

设置

bash
git clone # 克隆代码库（请替换为实际地址）

cd tomtom-mcp # 进入项目目录

npm install # 安装依赖

cp .env.example .env # 复制环境变量示例文件，并在 .env 中添加您的 API 密钥

npm run build # 构建 TypeScript 文件

node ./bin/tomtom-mcp.js # 启动 MCP 服务器

测试

bash
npm run build # 构建 TypeScript
npm test # 运行所有测试
npm run test:unit # 仅运行单元测试
npm run test:comprehensive # 运行集成测试

测试要求

⚠️ 重要提示：所有测试都需要在 .env 文件中提供有效的 API 密钥，因为它们会进行真实的 API 调用（非模拟）。这将消耗您的 API 配额。

项目结构

src/
├── tools/ # MCP 工具定义
├── services/ # TomTom API 包装器
├── schemas/ # 验证模式
├── utils/ # 工具函数
└── createServer.ts # MCP 服务器创建逻辑
└── index.ts # 主入口点

故障排除

API 密钥问题

bash

Linux/macOS 检查环境变量

echo $TOMTOM_API_KEY

Windows CMD: echo %TOMTOM_API_KEY%

Windows PowerShell: echo $env:TOMTOM_API_KEY

测试失败

bash
ls -la .env # 验证 .env 文件是否存在 (Linux/macOS)

Windows: dir .env

cat .env # 检查 API 密钥 (Linux/macOS)

Windows: type .env

构建问题

bash
npm run build # 重新构建
npm cache clean --force # 清除缓存

查看源码 项目主页

相关 MCP 服务

高德地图
@amap/amap-maps
高德地图是一个支持任何MCP协议客户端的服务器，允许用户轻松利用高德地图MCP服务器获取各种基于位置的服务。
12306-MCP车票查询工具
@Joooook/12306-mcp
基于Model Context Protocol (MCP) 的12306购票搜索服务器。提供了简单的API接口，允许大模型利用接口搜索12306购票信息。
百度地图
@baidu-maps/mcp
百度地图提供的MCP Server，包含10个符合MCP协议标准的API接口，涵盖逆地理编码、地点检索、路线规划等。 （正文语言为中文，无需翻译）
麦当劳MCP Server
MChina/mcd_mcp_server
暂无简介