MCP Ip2location Io

🚀 IP2Location.io MCP服務器

這是一個針對IP2Location.io API的簡單模型上下文協議（MCP）服務器實現。它能為任何給定的IPv4或IPv6地址返回詳細的地理位置信息。

✨ 主要特性

• 全面的地理位置數據：可檢索廣泛的信息，包括國家、地區、城市、緯度、經度、郵政編碼、時區等。
• 網絡詳情：提供與網絡相關的數據，如自治系統編號（ASN）、互聯網服務提供商（ISP）、域名和網絡速度。
• 安全洞察：檢測代理信息，包括代理類型和提供商。
• 簡單集成：作為FastMCP工具構建，可輕鬆集成到兼容系統中。
• 異步處理：使用httpx進行非阻塞異步API請求。

📦 安裝指南

此MCP服務器支持在不使用API密鑰的情況下進行查詢，但每天限制為1000次查詢。你也可以註冊獲取免費的API密鑰，每月最多可享受50,000次查詢。

設置過程還會使用uv，可按照指南進行安裝。

🚀 快速開始

按照以下步驟在Claude桌面版中使用此MCP服務器：

1. 將倉庫下載到本地。
2. 設置uv包管理器，可再次參考指南進行操作。
3. 確保你已安裝Claude桌面版，若未安裝，Windows和MacOS用戶可從此處下載，Linux用戶可遵循此指南進行安裝。
4. 使用你選擇的編輯器打開claude_desktop_config.json，若你還沒有該文件，可遵循此指南創建。
5. 在claude_desktop_config.json中添加以下內容：

{
  "mcpServers": {
    "ip2locationio": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/ip2locationio/src",
        "run",
        "server.py"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}

6. 請記得將/path/to/ip2locationio路徑替換為你本地IP2Location.io MCP服務器的實際路徑。
7. 要獲取API密鑰，只需登錄到你的儀表盤並從中獲取。將上述<YOUR API key HERE>替換為你實際的API密鑰。
8. 保存更改後重啟Claude桌面版，你應該會在“搜索和工具”菜單中看到它。

💻 使用示例

在Claude桌面版的聊天中輸入關於IP的查詢即可。以下是一些示例查詢：

• (IP)的位置在哪裡？
• (IP)位於何處？
• (IP)的座標是多少？

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

在Claude桌面版中，模型將根據IP2Location.io MCP服務器返回的結果自動生成輸出。

🔧 技術細節

環境變量

IP2LOCATION_API_KEY

這是IP2Location.io的API密鑰，使用該密鑰每月最多可進行50,000次查詢，並獲取更詳細的IP地址信息。你可以註冊獲取免費的API密鑰，或訂閱套餐以享受更多權益。

工具

get_geolocation

描述 獲取給定IP地址的地理位置信息。它幫助用戶檢索任何IPv4或IPv6地址的詳細信息，如國家、地區、城市、緯度、經度、郵政編碼、時區、自治系統編號（ASN）和代理信息。

參數 ip (str)：要分析的IP地址（IPv4或IPv6）。

返回值 一個包含地理位置數據的JSON字符串。根據你的API套餐，結果可能包含以下字段：

• 位置與地理信息：國家、地區、行政區、城市、郵政編碼、緯度和經度、時區。
• 網絡與連接信息：自治系統編號（ASN）、互聯網服務提供商（ISP）、域名、網絡速度、國際直撥代碼（IDD）、區號、地址類型、使用類型。
• 移動信息：移動網絡代碼（MNC）、移動國家代碼（MCC）、移動品牌。
• 貨幣與語言信息：貨幣代碼、貨幣名稱、貨幣符號、語言代碼、語言名稱。
• 代理與安全信息：代理類型、最後出現時間、威脅級別/類型、代理提供商、欺詐評分。
• 其他信息：互聯網廣告局（IAB）類別、天氣、海拔、人口等。

如果請求失敗或IP地址無效，該工具將返回一個錯誤消息字符串。

📄 許可證

請參閱LICENSE文件。