Tomtom MCP

🚀 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