Tomtom MCP

🚀 TomTom MCP Server

TomTom MCP Server は、検索、ルート案内、交通情報、静的マップデータなど、TomTomの位置情報サービスへのシームレスなアクセスを提供することで、地理空間開発を簡素化します。高精度な地理位置情報をAIワークフローや開発環境に簡単に統合することができます。

🎬 デモ

📑 目次

• デモ
• クイックスタート
  • 前提条件
  • インストール
  • 設定
  • 使用方法
• 統合ガイド
• 利用可能なツール
• コントリビューションとローカル開発
  • セットアップ
  • テスト
  • プロジェクト構造
• トラブルシューティング
• コントリビューションとフィードバック
• ライセンス

🚀 クイックスタート

前提条件

• Node.js 22+
• TomTom APIキー

TomTom APIキーの取得方法：

1. TomTom Developer Portal で開発者アカウントを作成します。
2. 左側のメニューで API & SDK Keys に移動します。
3. 赤いCreate Key ボタンをクリックします。
4. 全ての利用可能なAPIを選択して完全なアクセスを確保し、キーに名前を付けて Create をクリックします。

詳細については、TomTom API Key Management Documentation を参照してください。

インストール

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 Desktop Setup - Claude DesktopをTomTom MCPサーバーと連携するための設定手順
• VS Code Setup - Visual Studio Codeで開発環境を設定する方法
• Cursor AI Integration - TomTom MCPサーバーをCursor AIと統合するためのガイド
• WinSurf Integration - WindSurfをTomTom MCPサーバーを使用するように設定する手順
• Smolagents Integration - 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  # 統合テストを実行します

テスト要件

⚠️ 重要な注意

すべてのテストは、実際のAPI呼び出しを行うため（モックではない）、.envに有効な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 を参照してください。

すべてのコントリビューションは、Code of Conduct に準拠し、Developer Certificate of Origin (DCO) に従って署名する必要があります。

GitHubリポジトリ で問題を開いてください。

🔒 セキュリティ

セキュリティ脆弱性の報告方法とセキュリティ対策については、Security Policy を参照してください。

📄 ライセンス

このプロジェクトは、Apache License 2.0の下でライセンスされています。詳細については、LICENSE.md ファイルを参照してください。

Copyright (C) 2025 TomTom NV