MCP Hello World

🚀 Google Maps MCP 服務器

Google Maps MCP 服務器是為 Google Maps API 打造的服務器，它能借助一系列工具實現地址與座標轉換、地點搜索、距離計算等功能，為地圖相關應用開發提供有力支持。

🚀 快速開始

要使用 Google Maps MCP 服務器，你需要按照以下步驟進行設置：

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>"
      }
    }
  }
}

✨ 主要特性

此服務器提供了一系列實用工具，具體如下：

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"。
   • 返回：包含步驟、距離、時長的路線詳情。

📦 安裝指南

Docker 構建

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

📄 許可證

此 MCP 服務器採用 MIT 許可證授權。這意味著你可以自由使用、修改和分發該軟件，但需遵守 MIT 許可證的條款和條件。更多詳細信息，請參閱項目倉庫中的 LICENSE 文件。