🚀 TomTom MCP Server

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

🔍 演示

📑 目录

• 演示
• 快速开始
  • 前提条件
  • 安装
  • 配置
  • 使用方法
• 集成指南
• 可用工具
• 贡献与本地开发
  • 设置
  • 测试
  • 项目结构
• 故障排除
• 贡献与反馈
• 许可证

🚀 快速开始

📋 前提条件

• Node.js 22+
• TomTom API 密钥

如何获取 TomTom API 密钥：

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

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

💾 安装

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

# 或者不安装直接运行
npx @tomtom-org/tomtom-mcp@latest

⚙️ 配置

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

# 选项 1：使用 .env 文件（推荐）
echo "TOMTOM_API_KEY=your_api_key" > .env

# 选项 2：环境变量
export TOMTOM_API_KEY=your_api_key

# 选项 3：作为 CLI 参数传递
npx @tomtom-org/tomtom-mcp@latest --key your_api_key

💻 使用方法

# 启动 MCP 服务器
npx @tomtom-org/tomtom-mcp@latest
# 获取帮助
npx @tomtom-org/tomtom-mcp@latest --help

🧩 集成指南

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

以下指南将帮助你将 MCP 服务器与你的工具和环境进行集成：

• Claude 桌面设置 - 配置 Claude 桌面以与 TomTom MCP 服务器配合使用的说明。
• VS Code 设置 - 在 Visual Studio Code 中设置开发环境。
• Cursor AI 集成 - 将 TomTom MCP 服务器与 Cursor AI 集成的指南。
• WinSurf 集成 - 配置 WindSurf 以使用 TomTom MCP 服务器的说明。
• Smolagents 集成 - 展示如何将 Smolagents AI 代理连接到 TomTom MCP 服务器的示例。

🛠️ 可用工具

🤝 贡献与本地开发

⚙️ 设置

git clone <repository>

cd tomtom-mcp

npm install

cp .env.example .env      # 在 .env 中添加你的 API 密钥

npm run build             # 构建 TypeScript 文件

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

🧪 测试

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 密钥问题

echo $TOMTOM_API_KEY  # 检查是否已设置

测试失败

ls -la .env          # 验证 .env 文件是否存在
cat .env             # 检查 API 密钥

构建问题

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

📣 贡献与反馈

我们欢迎对 TomTom MCP Server 进行贡献！请参阅 CONTRIBUTING.md 以了解如何提交拉取请求、报告问题和提出改进建议的详细信息。

所有贡献都必须遵守我们的 行为准则，并根据 开发者原产地证书 (DCO) 进行签名。

在 GitHub 仓库 上提出问题。

🔒 安全

有关报告安全漏洞和我们的安全实践的信息，请参阅 安全策略。

📄 许可证

本项目采用 Apache 许可证 2.0 版 - 有关详细信息，请参阅 LICENSE.md 文件。

版权所有 (C) 2025 TomTom NV