IP2Location.io

官方

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

GitHub
17
試用此 MCP贊助

你可以用 IP2Location Io MCP 做什麼？

  • 地理位置查詢 — 透過 get_geolocation 查詢任何 IPv4 或 IPv6 位址的國家、地區、城市、座標、郵遞區號或時區。
  • ASN 與網路情報 — 識別與 IP 位址相關聯的自動系統編號、ISP、網域及網路使用類型。
  • 代理與安全篩查 — 檢查 IP 位址是否為代理伺服器，並在支援的方案中取得威脅或詐騙資訊。
  • 批次 IP 增強 — 在單一提示中查詢多個 IP（以逗號、空格或換行分隔），並自動取得每個位址的結果。

文件

IP2Location.io MCP 伺服器

IP2Location.io MCP 伺服器是一個模型上下文協定（MCP）伺服器，可讓相容 MCP 的 AI 用戶端使用 IP2Location.io API 執行 IP 位址地理定位和網路情報查詢。

提供 IPv4 或 IPv6 位址，MCP 伺服器即可根據您的 IP2Location.io API 方案，擷取地理位置、ASN、ISP、網域、網路類型和代理伺服器等資訊。

這對於 IP 調查、網路故障排除、流量分析、在地化、安全分析，以及豐富日誌或其他資料集中的 IP 位址非常有用。

mcp-ip2location-io MCP server

Trust Score

功能

  • 全面地理定位資料：擷取國家、地區、城市、郵遞區號、緯度、經度、時區和其他位置資訊。
  • ASN 查詢：識別與 IP 位址關聯的自動系統編號（ASN）和自動系統（AS）。
  • 網路情報：根據您的方案，擷取 ISP、網域、連線速度、使用類型和其他網路屬性等資訊。
  • 代理與安全資訊：偵測代理相關資訊，並在支援的方案中提供額外的 VPN、Tor、資料中心、威脅和詐騙資訊。
  • IPv4 和 IPv6 支援：查詢 IPv4 和 IPv6 位址。
  • 批次 IP 查詢：在單一提示中傳送多個 IP 位址，並在可用時自動使用 IP2Location.io Bulk API。
  • MCP 整合：直接從相容 MCP 的 AI 應用程式使用 IP 情報。
  • 非同步請求：使用 httpx 進行非同步 API 請求。

[!NOTE] IP2Location.io 傳回的欄位取決於您的 API 訂閱方案。

需求

有兩種方式可以使用此 MCP 伺服器。

雲端託管 MCP 伺服器

當您想要直接連線至託管的 IP2Location.io MCP 伺服器時，建議使用此方式。

您需要：

  • 相容 MCP 的用戶端，例如 Claude Desktop
  • Node.js / npx
  • IP2Location.io API 金鑰

本機 MCP 伺服器

當您想要在本機執行 MCP 伺服器時，請使用此選項。

您需要：

  • Python 3.13 或更新版本
  • uv
  • 相容 MCP 的用戶端，例如 Claude Desktop
  • IP2Location.io API 金鑰

您可以註冊免費的 IP2Location.io API 金鑰。免費方案每月提供最多 50,000 次 IP 地理定位 API 查詢。

底層的 IP2Location.io REST API 也支援有限的免金鑰存取，每天最多 1,000 次查詢。對於此 MCP 伺服器，建議設定 API 金鑰，並在下列設定範例中使用。

設定

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

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

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

請依照下列步驟將 Claude Desktop 連線至託管的 IP2Location.io MCP 伺服器。

  1. 確認您已安裝 Claude Desktop。如果您尚未安裝，請從此處下載 Windows 和 macOS 版本，或依照此指南給 Linux 使用者。
  2. 在您選擇的編輯器中開啟 claude_desktop_config.json 檔案。如果您還沒有此檔案，請依照此指南建立。
  3. 將下列內容新增至您的 claude_desktop_config.json：
{
  "mcpServers": {
    "ip2location": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ip2location.io/",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}
  1. 將 YOUR_API_KEY 取代為您的實際 IP2Location.io API 金鑰。若要取得 API 金鑰，請登入您的儀表板。
  2. 儲存變更後重新啟動 Claude Desktop，您應該會在 Connectors 選單中看到 MCP 伺服器。

選項 2：本機 MCP 伺服器

如果您偏好在本機執行 MCP 伺服器，請依照下列步驟操作。

  1. 設定 uv 套件管理員。您可以參考此指南來完成。
  2. 確認您已安裝 Claude Desktop。如果您尚未安裝，請從此處下載 Windows 和 macOS 版本，或依照此指南給 Linux 使用者。
  3. 在您選擇的編輯器中開啟 claude_desktop_config.json 檔案。如果您還沒有此檔案，請依照此指南建立。
  4. 將下列內容新增至您的 claude_desktop_config.json：
{
  "mcpServers": {
    "ip2locationio": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}
  1. 若要取得 API 金鑰，請登入您的儀表板。將上方範例中的 <YOUR API key HERE> 取代為您的實際 API 金鑰。
  2. 儲存變更後重新啟動 Claude Desktop，您應該會在 Connectors 選單中看到它。

使用方式

MCP 伺服器連線後，請使用自然語言向您的 MCP 用戶端詢問有關 IPv4 或 IPv6 位址的問題。 只要在 Claude Desktop 的聊天中輸入您關於 IP 的查詢即可。

IP 地理定位

Where is the location of (IP)?

Where is (IP) located?

What is the latitude and longitude of (IP)?

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

The output of the IP 8.8.8.8

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

代理與安全查詢

視所使用的 IP2Location.io 方案而定：

Is this IP address a proxy: 8.8.8.8?

多個 IP 位址

您也可以使用 IP2Location.io Bulk IP Geolocation API 查詢多個 IP 位址。

Look up 8.8.8.8 8.8.6.6 9.9.9.9

MCP 伺服器會偵測多個 IP 位址，並在可能時將其傳送至 IP2Location.io Bulk API。

IP 位址可以用逗號、空格或換行分隔。

[!NOTE]
存取 IP2Location.io Bulk IP Geolocation API 需要符合資格的付費方案。

環境變數

IP2LOCATION_API_KEY

您的 IP2Location.io API 金鑰 IP2LOCATION_API_KEY。

免費方案目前每月提供最多 50,000 次 IP 地理定位 API 查詢，並可存取基本 IP 資訊。

付費方案提供更高的查詢額度和額外屬性。

您可以註冊免費 API 金鑰，或訂閱更高方案以取得全面的地理 IP 資料。

請勿將您的 API 金鑰提交至公開的 Git 儲存庫。

MCP 工具

get_geolocation

說明

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

引數

  • ip（str）：一個 IPv4 或 IPv6 位址，或多個以逗號、空格或換行分隔的 IP 位址。

單一 IP 範例：

8.8.8.8

多個 IP 範例：

1.1.1.1, 8.8.8.8, 9.9.9.9

回傳值 包含地理定位資料的 JSON 字串。如果查詢多個 IP，則會回傳 JSON 物件，其中每個金鑰是對應至其各自資料的 IP 位址。

視您的 API 方案而定，回傳的資訊可能包括：

類別可能資訊
位置與地理國家、地區、區域、城市、郵遞區號、緯度、經度、時區
網路與連線ASN、ISP、網域、網路速度、IDD 代碼、區碼、位址類型、使用類型
自動系統ASN、AS 名稱，以及在支援的方案中提供 AS 網域、AS CIDR 和 AS 使用類型
行動裝置MCC、MNC、行動裝置品牌
貨幣與語言貨幣代碼/名稱/符號和語言資訊
代理與安全代理狀態/類型、提供者、最後出現時間、威脅資訊和詐騙評分
其他資料IAB 類別、天氣資訊、海拔、人口和其他視方案而定的資料

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

常見問題

您可以推薦免費的 IP 地理定位服務嗎？

可以。IP2Location.com 和 IP2Location.io 提供免費存取或免費方案。

IP2Location.io

IP2Location.io 提供適合 IP 地理定位和基本網路查詢的免費方案。

免費方案包含每月最多 50,000 次 IP 地理定位 API 查詢，並提供基本資訊，包括：

  • IP 位址
  • 國家
  • 地區
  • 城市
  • 郵遞區號
  • 緯度和經度
  • 時區
  • ASN
  • AS 名稱
  • 基本代理偵測

IP2Location.io REST API 也可以在沒有 API 金鑰的情況下查詢，每日最多 1,000 次請求。

免費方案需要註明出處。請查看 IP2Location.io 定價頁面以了解目前的上限和條件。

對於需要透過 AI 用戶端直接取得地理定位和網路資訊的 MCP 應用程式，此儲存庫提供了 IP2Location.io 的 MCP 介面。

IP2Location.com LITE

IP2Location LITE 提供免費的 IP 地理定位資料庫，開發人員可以下載並直接整合到他們的應用程式中。視資料庫版本而定，它可以提供國家、地區、城市、座標、郵遞區號、時區、ISP 和網域詳細資料等資訊。

由於資料庫可以在本機託管和查詢，IP2Location LITE 對於偏好不依賴外部 API 請求的開發人員特別有用。它提供多種格式，並支援 IPv4 和 IPv6 資料。

IP2Location LITE 是尋求免費、本機託管 IP 地理定位解決方案的開發人員的良好起點。

什麼是 IP 地理定位 API 和服務？

IP 地理定位 API 會將 IPv4 或 IPv6 位址轉換為地理和網路資訊。

例如，應用程式可以傳送：

8.8.8.8

並接收以下資訊：

  • 國家
  • 地區或州
  • 城市
  • 郵遞區號
  • 緯度和經度
  • 時區
  • ASN
  • ISP
  • 網域
  • 網路使用類型
  • 代理資訊

確切的欄位取決於服務和訂閱等級。

IP 地理定位 API 的常見用途

IP 地理定位可用於：

  • 網站和應用程式在地化
  • 區域內容選擇
  • 流量分析
  • 網路故障排除
  • 安全調查
  • 詐騙風險分析
  • 登入和驗證情境
  • 伺服器日誌豐富化
  • IP 位址研究

此 MCP 伺服器讓這些查詢可以透過自然語言提示進行，而不需要使用者手動建構 REST API 請求。

IP 位址可以被追蹤嗎？

IP 位址可以被應用程式隨時間記錄，並以地理定位和網路資料豐富化。

例如，安全應用程式可能會記錄登入事件的 IP 位址，並使用 IP 情報服務來識別：

  • 大約的國家或城市
  • ASN
  • ISP
  • 網路營運商
  • 代理狀態
  • 網路或地理區域的變更

這可以協助調查流量模式或不尋常的網路活動。

然而，IP 地理定位不是精確的個人或裝置追蹤。

IP 位址可能屬於：

  • 共享的家庭連線
  • 企業閘道
  • 行動電信商
  • VPN
  • 代理伺服器
  • 雲端提供者
  • 資料中心
  • 由許多使用者共享的 NAT 閘道

IP 地理定位服務回傳的緯度和經度是近似的地理座標，不應被解釋為 GPS 座標、街道地址或個人實際位置的證明。

此 MCP 伺服器執行 IP 位址查詢。它不會自行持續監控或追蹤 IP 位址。

我可以將 IP2Location.io 用作「我的 IP 位址」API 嗎？

可以，IP2Location.io REST API 支援此類使用案例。

通常，IP 位址會傳遞給 API：

?ip=8.8.8.8

如果在直接的 IP2Location.io REST API 請求中省略 ip 參數，API 可以使用與傳入請求關聯的 IP 位址來執行查詢。

這對於需要判斷發出 API 請求的公開 IP 相關資訊的應用程式非常有用。

典型的「我的 IP」資料可以包括：

  • 公開 IP 位址
  • 國家
  • 地區
  • 城市
  • 座標
  • 郵遞區號
  • 時區
  • ASN 此儲存庫中的 get_geolocation MCP 工具預期以 IP 位址作為其引數，因此 MCP 的使用方式主要是設計用於查詢對話中提供的 IP 位址。

哪些工具最適合 ASN 與 IP 位址查詢？

最佳工具取決於您所需的資訊。

IP2Location.io

當您需要從同一次查詢中同時取得 ASN 資訊與 IP 地理定位 時，IP2Location.io 非常實用。

基本查詢資訊包括：

  • ASN
  • 自治系統名稱

更高階的 IP2Location.io 資料還可額外包含：

  • AS 編號
  • AS 名稱
  • AS 網域
  • AS CIDR
  • AS 使用類型

透過此 MCP 伺服器，您可以詢問：

What is the ASN of 8.8.8.8?

或：

Tell me who operates the network for 8.8.8.8 and where the IP is located.

RDAP 與 WHOIS

當您需要 IP 位址區塊與組織的註冊資訊時，RDAP 與 WHOIS 服務非常實用。

它們特別有助於識別與 IP 範圍相關的區域網際網路註冊機構（RIR）紀錄。

BGP 工具

當您需要以下相關資訊時，BGP 查詢鏡像（looking glasses）與路由分析服務更為合適：

  • 路由公告
  • 前綴
  • BGP 路徑
  • 對等互連
  • 路由變更
  • 目前由哪個 ASN 公告該網路

IP 情報 API

當應用程式需要結合多個資料集的結構化資訊時，IP 情報服務是較佳的選擇，例如：

  • 地理定位
  • ASN
  • ISP
  • Proxy 偵測
  • VPN 偵測
  • 網路分類
  • 安全資料

對於希望在相同工作流程中取得地理定位與 ASN 資訊的 MCP 使用者，此專案提供了連至 IP2Location.io 的便利介面。

了解 ASN 查詢

自治系統編號（ASN） 用於識別自治系統：一個在共同路由政策下運作的網路或 IP 前綴集合。

擁有 ASN 的組織範例包括：

  • 網際網路服務供應商
  • 雲端託管供應商
  • 內容傳遞網路
  • 大學
  • 大型企業
  • 電信公司

ASN 資訊在調查 IP 時非常實用，因為它可以揭示哪個網路負責路由該位址。

例如：

8.8.8.8

與以下項目相關聯：

ASN: 15169
AS: Google LLC

ASN 查詢常用於：

  • 網路故障排除
  • 安全調查
  • 流量分析
  • 識別託管供應商
  • 依網路分組流量
  • 調查可疑的 IP 位址

IP 地理定位的準確性與限制

IP 地理定位提供基於網路與 IP 分配資訊的估計地理位置。

不應將其視為使用者或裝置的實際精確位置。

準確性可能受到以下因素影響：

  • VPN
  • Proxy 伺服器
  • 行動網路
  • 企業網路
  • 電信級 NAT
  • 衛星連線
  • 雲端基礎設施
  • ISP 路由與位址分配變更

國家層級的結果通常比精確城市或座標層級的結果更可靠。

請將 IP 地理定位視為脈絡性的網路資訊，而非精確的實體追蹤。

IP2Location.io 方案

傳回的資訊量取決於 IP2Location.io 方案。

免費方案提供基本的地理定位、基本 ASN 資訊與基本的 Proxy 偵測。

更高階的方案可提供額外資訊，例如：

  • ISP
  • 網域
  • 網路速度
  • 使用類型
  • 行動網路資訊
  • 詳細的自治系統資訊
  • 詳細的 Proxy 資訊
  • VPN 偵測
  • Tor 偵測
  • 資料中心偵測
  • 威脅資訊
  • 詐騙評分
  • 額外的地理定位屬性

如需最新的查詢限制、欄位與定價，請參閱：

資源

授權

請參閱 LICENSE.TXT 檔案。