mcp-server-iplocate - 集成IPLocate.io，提供IP多維度數據查詢的MCP工具

探索

MCP Server Iplocate

IPLocate.io的MCP服務器，提供IP地址的地理位置、網絡信息、隱私檢測和濫用聯繫人等全面數據查詢服務。

位置服務安全 #IP查詢 #地理位置 #網絡安全 #網絡分析 .TypeScript

評分 : 2.5分

下載量 : 2

更新時間 : 2025-07-25

安裝

複製以下命令到你的Client進行配置

{
     "mcpServers": {
       "iplocate": {
         "command": "npx",
         "args": ["-y", "@iplocate/mcp-server"],
         "env": {
           "IPLOCATE_API_KEY": "your_api_key_here"
         }
       }
     }
   }

注意：您的密鑰屬於敏感信息，請勿與任何人分享。

🚀 IPLocate.io IP地址地理定位及網絡數據MCP服務器

本項目是一個用於 IPLocate.io 的MCP（模型上下文協議）服務器，能提供全面的IP地址情報，包括地理定位、網絡信息、隱私檢測和濫用聯繫人信息等，助力用戶深入瞭解IP地址相關情況。

🚀 快速開始

使用此MCP服務器最簡單的方法是通過您的MCP客戶端。只需按照以下設置說明配置您的客戶端：

配置您的MCP客戶端

Cursor

一鍵設置：

手動配置：

在您的項目目錄中創建配置文件：
```
mkdir -p .cursor
touch .cursor/mcp.json
```

將以下內容添加到 .cursor/mcp.json 中：

{
  "mcpServers": {
    "iplocate": {
      "command": "npx",
      "args": ["-y", "@iplocate/mcp-server"],
      "env": {
        "IPLOCATE_API_KEY": "your_api_key_here"
      }
    }
  }
}

請將 your_api_key_here 替換為您從 IPLocate.io 獲取的實際API密鑰。

Claude Desktop

打開Claude Desktop設置
- 在macOS上：按 Cmd + ,
- 在Windows上：按 Ctrl + ,
轉到“開發者”選項卡，然後點擊“編輯配置”

添加IPLocate服務器配置：

{
  "mcpServers": {
    "iplocate": {
      "command": "npx",
      "args": ["-y", "@iplocate/mcp-server"],
      "env": {
        "IPLOCATE_API_KEY": "your_api_key_here"
      }
    }
  }
}

請將 your_api_key_here 替換為您從 IPLocate.io 獲取的實際API密鑰。

VS Code（預覽版）

創建VS Code MCP配置文件：

mkdir -p .vscode
touch .vscode/mcp.json

將以下內容添加到 .vscode/mcp.json 中：

{
  "servers": {
    "iplocate": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@iplocate/mcp-server"],
      "env": {
        "IPLOCATE_API_KEY": "your_api_key_here"
      }
    }
  }
}

請將 your_api_key_here 替換為您從 IPLocate.io 獲取的實際API密鑰。

可用工具

服務器提供以下工具：

`lookup_ip_address_details`

獲取有關IP地址的全面信息，包括所有可用數據。

參數：

ip（可選）：要查詢的IPv4或IPv6地址。如果未提供，則返回調用者IP地址的信息。

示例：

{
  "ip": "8.8.8.8"
}

返回： 有關IP地址的所有可用數據，包括地理位置、網絡信息、隱私和公司數據。

`lookup_ip_address_location`

獲取IP地址的地理位置信息。

參數：

ip（可選）：要查詢的IPv4或IPv6地址。

返回： 國家、城市、座標、時區、郵政編碼等。

`lookup_ip_address_privacy`

檢查IP地址是否被檢測為VPN、代理、其他匿名服務；是否在濫用黑名單中；或者是否為託管服務提供商。

參數：

ip（可選）：要查詢的IPv4或IPv6地址。

返回： VPN狀態、代理檢測、Tor出口節點狀態、託管服務提供商信息。

`lookup_ip_address_network`

獲取IP地址的網絡和ASN（自治系統編號）信息。

參數：

ip（可選）：要查詢的IPv4或IPv6地址。

返回： ASN詳細信息、網絡範圍、ISP信息、區域註冊表。

`lookup_ip_address_company`

獲取IP地址的公司/組織信息。

參數：

ip（可選）：要查詢的IPv4或IPv6地址。

返回： 公司名稱、域名、國家、組織類型。

`lookup_ip_address_abuse_contacts`

獲取IP地址的濫用聯繫人信息，用於報告惡意活動。

參數：

ip（可選）：要查詢的IPv4或IPv6地址。

返回： 濫用聯繫人電子郵件、電話、地址和網絡範圍。

可用提示

服務器還提供預配置的提示，以幫助進行常見的IP分析任務：

`check_ip_security`

分析IP地址的安全問題，包括VPN、代理、Tor使用和濫用歷史。

示例用法： "使用 check_ip_security 提示分析192.168.1.1"

`locate_ip_geographically`

獲取有關IP地址的詳細地理信息。

示例用法： "使用 locate_ip_geographically 提示查找我的位置"

`investigate_ip_ownership`

獲取有關誰擁有和運營IP地址的詳細信息。

示例用法： "使用 investigate_ip_ownership 提示檢查誰擁有8.8.8.8"

`ip_comparison`

比較兩個IP地址之間的地理和網絡信息。

示例用法： "使用 ip_comparison 提示比較1.1.1.1和8.8.8.8"

✨ 主要特性

此MCP服務器提供了查詢IP地址詳細信息的工具：

地理位置：國家、城市、座標、時區、郵政編碼等
網絡信息：ASN名稱、編號、類型、網絡範圍、ISP信息
隱私與安全：VPN檢測、代理檢測、Tor出口節點、託管服務提供商
公司數據：組織名稱、域名、業務類型
濫用聯繫人：用於報告惡意活動的電子郵件、電話和地址

📦 安裝指南

要遵循我們的快速啟動設置說明，您需要：

Node.js 18或更高版本
npm
兼容的MCP客戶端。例如，Cursor、Claude Desktop。

手動運行服務器

如果您需要手動運行服務器（用於開發或測試），您有以下幾種選擇：

前提條件

Node.js 18或更高版本
npm或yarn

使用npx（推薦）

npx -y @iplocate/mcp-server

使用API密鑰：

在macOS/Linux上：

export IPLOCATE_API_KEY=your_api_key_here
npx -y @iplocate/mcp-server

在Windows上：

set IPLOCATE_API_KEY=your_api_key_here
npx -y @iplocate/mcp-server

從npm安裝

npm install -g @iplocate/mcp-server
mcp-server-iplocate

從源代碼安裝

git clone https://github.com/iplocate/mcp-server-iplocate.git
cd mcp-server-iplocate
yarn install
yarn build
yarn start

用於開發並自動重新加載：

yarn dev

測試

您可以使用 MCP Inspector 測試服務器：

npx @modelcontextprotocol/inspector node dist/index.js

📚 詳細文檔

添加您的API密鑰

在沒有API密鑰的情況下，您每天最多可以進行50次請求。在 IPLocate.io 上註冊免費API密鑰，可將您的免費配額提高到 每天1000次請求。

註冊免費API密鑰

訪問 https://iplocate.io/signup
創建免費賬戶
從儀表板獲取您的API密鑰

在本服務器中使用API密鑰

服務器會自動從 IPLOCATE_API_KEY 環境變量中讀取您的API密鑰。您可以在MCP客戶端設置中進行配置（請參閱上面的配置示例），或者在手動運行時進行設置。

API響應格式

IPLocate API返回有關IP地址的全面數據。以下是一個示例響應結構：

{
  "ip": "8.8.8.8",
  "country": "United States",
  "country_code": "US",
  "city": "Mountain View",
  "latitude": 37.386,
  "longitude": -122.0838,
  "asn": {
    "asn": "AS15169",
    "name": "Google LLC",
    "domain": "google.com"
  },
  "privacy": {
    "is_vpn": false,
    "is_proxy": false,
    "is_tor": false,
    "is_hosting": true
  }
  // ... 還有更多字段
}