IP2Location.io MCP Server

官方

IP2Location.io API 整合，用於擷取 IP 地址的地理位置資訊。

GitHub

文件

IP2Location.io MCP 伺服器

這是一個針對 IP2Location.io API 的簡易模型上下文協定 (MCP) 伺服器實作。它會針對任何給定的 IPv4 或 IPv6 位址，回傳詳細的地理位置資訊。

功能特色

全面的地理位置資料：擷取廣泛的資訊，包括國家、地區、城市、緯度、經度、郵遞區號、時區等。
網路詳細資訊：提供網路相關資料，例如 ASN、ISP、網域和網路速度。
安全洞察：偵測代理資訊，包括代理類型和提供者。
簡易整合：建構為 FastMCP 工具，可輕鬆整合到相容的系統中。
非同步：利用 httpx 進行非阻塞的非同步 API 請求。

需求

此 MCP 伺服器支援無 API 金鑰的查詢，每日限制為 1,000 次查詢。您也可以註冊免費的 API 金鑰，每月最多可享 50,000 次查詢。

如果您使用雲端託管的 MCP 伺服器，則只需要 Claude Desktop 和 npx，因為伺服器是遠端託管的。如果您想在本機執行原始的 MCP 伺服器，本機設定會使用 uv，您可以按照此指南進行安裝。

設定

您可以透過以下任一方式在 Claude Desktop 中使用此 MCP 伺服器：

雲端託管的 MCP 伺服器：如果您想直接連線到託管的 IP2Location.io MCP 伺服器，建議使用此方式。
本機 MCP 伺服器：如果您想在自己的電腦上下載並執行原始的 MCP 伺服器，請使用此方式。

選項 1：雲端託管的 MCP 伺服器

請按照以下步驟，搭配 Claude Desktop 使用雲端託管的 IP2Location.io MCP 伺服器：

確保您已安裝 Claude Desktop。如果尚未安裝，請從此處下載 Windows 和 macOS 版本，或針對 Linux 使用者按照此指南操作。
使用您選擇的編輯器開啟 claude_desktop_config.json 檔案。如果還沒有，請按照此指南建立一個。
將以下內容新增到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "ip2location": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ip2location.io/",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}

將 YOUR_API_KEY 替換為您實際的 IP2Location.io API 金鑰。若要取得您的 API 金鑰，請登入您的儀表板。
儲存變更後重新啟動 Claude Desktop，您應該會在 Connectors 選單中看到 MCP 伺服器。

選項 2：本機 MCP 伺服器

如果您想在本機搭配 Claude Desktop 執行原始的 MCP 伺服器，請按照以下步驟操作：

設定 uv 套件管理器。您可以參考此指南來進行。
確保您已安裝 Claude Desktop。如果尚未安裝，請從此處下載 Windows 和 macOS 版本，或針對 Linux 使用者按照此指南操作。
使用您選擇的編輯器開啟 claude_desktop_config.json 檔案。如果還沒有，請按照此指南建立一個。
將以下內容新增到您的 claude_desktop_config.json：

{
  "mcpServers": {
    "ip2locationio": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}

若要取得您的 API 金鑰，請登入您的儀表板。將上方範例中的 <YOUR API key HERE> 替換為您實際的 API 金鑰。
儲存變更後重新啟動 Claude Desktop，您應該會在 Connectors 選單中看到它。

使用方式

只需在 Claude Desktop 的對話中輸入您關於 IP 的查詢。一些查詢範例如下：

(IP) 的位置在哪裡？
(IP) 位於哪裡？
(IP) 的座標是什麼？

例如，以下是 IP 8.8.8.8 的結果：

The output of the IP 8.8.8.8

在 Claude Desktop 中，模型會根據 IP2Location.io MCP 伺服器回傳的結果自動產生輸出。

您也可以利用 IP2Location.io 批量 IP 地理位置 API 來查詢多個 IP 位址。只需輸入所有 IP 位址，並在每個 IP 位址之間以空格分隔。例如 8.8.8.8 8.8.6.6。

[!NOTE]
IP2Location.io 批量 IP 地理位置 API 需要付費方案才能使用。

環境變數

IP2LOCATION_API_KEY

IP2Location.io API 金鑰，可讓您每月查詢最多 50,000 次，並取得 IP 位址的更多詳細資訊。您可以註冊免費的 API 金鑰，或訂閱方案以享受更多權益。

工具

get_geolocation

描述擷取給定 IP 位址或一批 IP 位址的地理位置。它可協助使用者擷取任何 IPv4 或 IPv6 位址的詳細資訊，例如國家、地區、城市、緯度、經度、郵遞區號、時區、ASN 和代理資訊。當偵測到多個 IP 時，它會自動將請求路由到 IP2Location.io 批量 API 以進行高效處理。

參數

ip (str)：要分析的 IP 位址（IPv4 或 IPv6）。您可以透過將多個 IP 以逗號、空格或換行符分隔的單一字串形式傳遞，來一次查詢多個 IP（例如 "1.1.1.1, 2.2.2.2"）。

回傳值 包含地理位置資料的 JSON 字串。如果查詢多個 IP，則會回傳一個 JSON 物件，其中每個鍵都是一個對應到其各自資料的 IP 位址。根據您的 API 方案，結果可能包含以下欄位：

位置與地理：國家、地區、行政區、城市、郵遞區號、緯度和經度、時區。
網路與連線：ASN（自治系統號碼）、ISP（網際網路服務供應商）、網域、網路速度、國際直撥電話代碼、區號、位址類型、使用類型。
行動資訊：MNC（行動網路代碼）、MCC（行動國家代碼）、行動品牌。
貨幣與語言：貨幣代碼、貨幣名稱、貨幣符號、語言代碼、語言名稱。
代理與安全：代理類型、最後出現時間、威脅等級/類型、代理提供者、詐欺分數。
其他：IAB 類別、天氣、海拔、人口等。

如果單一 IP 請求失敗或 IP 無效，工具會以字串形式回傳錯誤訊息。對於批量請求，任何個別失敗的 IP 都會回傳一個對應到該特定 IP 位址的錯誤物件，而不會導致整批請求失敗。

授權

請參閱 LICENSE 檔案。