MCP Hello World

🚀 Google Maps MCP Server

Google Maps API用のMCPサーバーです。このサーバーを使うことで、Google Maps APIの様々な機能を利用できます。

✨ 主な機能

1. maps_geocode

• 住所を座標に変換します。
• 入力: address (文字列)
• 返り値: 位置情報、整形された住所、場所ID

2. maps_reverse_geocode

• 座標を住所に変換します。
• 入力:
  • latitude (数値)
  • longitude (数値)
• 返り値: 整形された住所、場所ID、住所の構成要素

3. maps_search_places

• テキストクエリを使って場所を検索します。
• 入力:
  • query (文字列)
  • location (オプション): { latitude: 数値, longitude: 数値 }
  • radius (オプション): 数値 (メートル、最大50000)
• 返り値: 名前、住所、位置情報を持つ場所の配列

4. maps_place_details

• 場所の詳細情報を取得します。
• 入力: place_id (文字列)
• 返り値: 名前、住所、連絡先情報、評価、レビュー、開店時間

5. maps_distance_matrix

• 地点間の距離と時間を計算します。
• 入力:
  • origins (文字列配列)
  • destinations (文字列配列)
  • mode (オプション): "driving" | "walking" | "bicycling" | "transit"
• 返り値: 距離と所要時間の行列

6. maps_elevation

• 場所の標高データを取得します。
• 入力: locations ({latitude, longitude}の配列)
• 返り値: 各地点の標高データ

7. maps_directions

• 地点間の経路を取得します。
• 入力:
  • origin (文字列)
  • destination (文字列)
  • mode (オプション): "driving" | "walking" | "bicycling" | "transit"
• 返り値: ステップ、距離、所要時間を含む経路詳細

📦 インストール

APIキーの取得

こちらの手順に従って、Google Maps APIキーを取得してください。

Claude Desktopでの使用方法

claude_desktop_config.jsonに以下の内容を追加してください。

Dockerの場合

{
  "mcpServers": {
    "google-maps": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GOOGLE_MAPS_API_KEY",
        "mcp/google-maps"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

NPXの場合

{
  "mcpServers": {
    "google-maps": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-google-maps"
      ],
      "env": {
        "GOOGLE_MAPS_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

🔧 ビルド方法

Dockerでビルドするには、以下のコマンドを実行してください。

docker build -t mcp/google-maps -f src/google-maps/Dockerfile .

📄 ライセンス

このMCPサーバーはMITライセンスの下で提供されています。これは、MITライセンスの条件に従い、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリ内のLICENSEファイルを参照してください。