Amazon Location Service MCP Server

Amazon Location Service MCPサーバーとは？

Amazon Location Service MCPサーバーは、LLM駆動のツールやアシスタントをAmazon Location Service APIに接続するModel Context Protocol（MCP）の実装です。このサーバーを通じて、AIエージェントは場所を検索し、住所のジオコーディングや逆ジオコーディングを行い、ルートを計算し、他のAWS地理空間機能をMCP標準エンドポイントを使用して利用できます。LLM環境とAWSの強力な位置情報プラットフォームとの拡張可能なブリッジを提供し、対話的なシナリオや自動化ツールベースのシナリオで統合を容易にします。

Amazon Location Service MCPサーバーの設定方法

前提条件
- Astralからuvをインストールしてください。
- Pythonをインストールします（例：uv python install 3.10）。
- Amazon Location Serviceのアクセス権を持つAWSクレデンシャル（アクセスキーまたはAWSプロファイル）を設定します。

MCPサーバー設定の例

MCPクライアント設定ファイルにAmazon Location Service MCPサーバーのエントリを追加します（例：~/.aws/amazonq/mcp.json, .cursor/mcp.jsonなど）：

{
  "mcpServers": {
    "awslabs.aws-location-mcp-server": {
      "command": "uvx",
      "args": [
        "awslabs.aws-location-mcp-server@latest"
      ],
      "env": {
        "AWS_PROFILE": "your-aws-profile",
        "AWS_REGION": "us-east-1",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

環境変数
- 必要に応じてAWS_PROFILEおよびAWS_REGIONを設定します。
- コンテナ展開の場合、適切に--envまたは--env-file経由でクレデンシャルを渡します。
有効化
- MCPサーバーが有効（設定内で"disabled": trueとマークされていない）であることを確認します。
オプション
- あなたの組織のセキュリティベストプラクティスに従い、ログレベルをカスタマイズするか、役割ベースの認証を使用できます。

Amazon Location Service MCPサーバーの使用方法

利用可能なツールを発見する
- MCPクライアントインターフェースまたはAPIを使用して、tools/listエンドポイント経由でツールをリストします。これにより、場所検索やジオコーディングなどの地理ベースの機能が明らかになります。
位置ツールを呼び出す
- tools/callエンドポイントを使用して、関連するパラメータでツールを呼び出します。例えば、クエリとオプションのフィルターを提供して場所検索を行ったり、出発地と目的地の座標を提供してルートを取得します。
ワークフローにおける典型的なステップ
- LLMと統合されたIDEやチャットアプリケーションで、アシスタントにAmazon Location Service MCPツールを利用して次のようなタスクを促します：
  - 「オフィスの近くのコーヒーショップを探してください。」
  - 「この住所を緯度/経度に変換してください。」
  - 「ここから空港までの最適なルートは何ですか？」
クライアントでのツール承認
- プロンプトが表示された場合はツール呼び出しを承認します（多くのクライアントでは自動承認のオプションがあり、ワークフローを効率化します）。
結果を確認する
- AIアシスタントや自動化パイプラインは、構造化された応答（例：場所リスト、座標結果、ルート詳細）を受信し、さらなる処理、表示、コード生成、またはビジネスロジックの実行を行います。

コマンドライン使用のサンプル

テスト用にMCPサーバーを手動で実行します：

timeout 15s uv tool run awslabs.aws-location-mcp-server --region us-east-1 2>&1 || echo "完了またはタイムアウト"

主要機能

シームレスな場所検索：サポートされているAWSデータプロバイダーにわたるビジネス名、ランドマーク、および住所を問い合わせます。
ジオコーディングと逆ジオコーディング：住所と緯度/経度を相互に変換します。
ルート最適化：地図データに基づき、最適なルート、推定旅行時間、および距離を計算します。
MCPツール発見：LLMエージェントが直接利用可能な標準化されたドキュメント機能を公開します。
安全なAWS統合：位置情報のクエリおよびサービスへの制御されたアクセスにIAMロールとポリシーを活用します。
低遅延のローカルまたはクラウド展開：プライバシーのためにローカルでMCPサーバーを実行するか、常に利用可能でスケーラブルな使用のためにリモートで実行します。
拡張可能＆構成可能：アプリケーションや組織の要件に応じてエンドポイントやサービスを適応させることができます。

ユースケース

会話型アシスタント：LLM駆動のチャットボットがユーザーの位置に関する質問に回答したり、ライブの場所検索を行ったり、ビジネスや重要なポイントを提案します。
フィールドサービスの自動化：地理空間APIを通じて指示を自動生成し、フィールドルートを最適化し、結果をAI駆動のダッシュボードやワークフローに表示します。
カスタマーエクスペリエンスエージェント：自然言語を介してユーザーが店舗の場所を見つけたり、住所を確認したり、営業時間を調べるのを支援します。
アプリケーション開発：Web/Mobileアプリのバックエンドロジックの一部として、ジオコーディング、ルート計画、近接検索を統合します。
データアノテーション：非構造化された住所をジオロケートしたり、分析と視覚化のために正確な座標でデータセットにアノテーションを加えます。

よくある質問

Q1: Amazon Location Service MCPサーバーを使用するために必要なAWS権限は？
A1: 使用するAWSクレデンシャルまたはプロファイルは、geo:SearchPlaceIndexForText、geo:CalculateRouteなど、Amazon Location Serviceアクションにアクセスする権限を持っている必要があります。

Q2: 地理やデータプロバイダーによって応答を制限できますか？
A2: はい、MCPサーバーは、地域、バウンディングボックス、データプロバイダー、またはカスタムフィルターを指定するためのパラメータをサポートしています。これらはAmazon Location Service APIの規定に基づき、ツール呼び出しで構成できます。

Q3: このサーバーは位置データを保存したりログに記録したりしますか？
A3: デフォルトでは、サーバーは敏感な位置クエリや応答を保持したりログに記録したりしません。デバッグ用にログレベルを調整できますが、プライバシーに対する設定の見直しをお勧めします。

Q4: Amazon Location Service MCPサーバーをオフラインで実行できますか？
A4: サーバーはローカルで実行できますが、ライブ位置データを提供するためにはAWSに接続する必要があります。いくつかの限定的なキャッシュが実装される場合がありますが、ほとんどの機能はネットワークアクセスを必要とします。

Q5: LLMアシスタントでこれらの位置ツールをどのように使用しますか？
A5: 構成が完了したら、単にAIアシスタントに希望する位置ツールを使用するように促すか、LLMが自動的に関連するツールを選択することができます。承認と結果の管理はクライアントインターフェースを通じて行います。

プロトコル名	説明
searchPlaces	テキストクエリとオプションのフィルター（例：カテゴリ、バウンディングボックス、最大結果）に基づいて、場所、ビジネス、または住所を検索します。一致する場所のランキングリストと位置詳細およびコンテキストメタデータを返します。
geocodeAddress	人が読みやすい住所を、Amazon Location ServiceのジオコーディングAPIを使用して、地理的座標（緯度と経度）に変換します。
reverseGeocode	指定された座標（緯度、経度）を使用して、最寄りの既知の住所または場所を解決します。逆ジオコーディングエンドポイントを利用します。
calculateRoute	2つ以上のポイント間の最適な運転、徒歩、または公共交通機関のルートを計算します。指示、推定旅行時間、および距離を返し、提供された場合は経由地も含まれます。