IPLocate

来自 IPLocate.io 的 IP 地址地理位置和网络数据 MCP 服务

适用于 IPLocate.io 的 MCP（Model Context Protocol）服务，提供全面的 IP 地址情报，包括地理位置、网络信息、隐私检测和滥用联系信息。

功能

此 MCP 服务提供用于查询 IP 地址详细信息的工具：

• 地理位置：国家、城市、坐标、时区、邮政编码等
• 网络信息：ASN 名称、编号、类型、网络范围、ISP 信息
• 隐私与安全：VPN 检测、代理检测、Tor 出口节点、托管服务提供商
• 公司数据：组织名称、域名、业务类型
• 滥用联系信息：用于举报恶意活动的电子邮件、电话和地址

要求

按照快速入门设置说明操作，你需要：

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

快速入门

通过 MCP 客户端使用此 MCP 服务是最简单的方式。只需按照以下设置说明配置客户端：

配置 MCP 客户端

Cursor

一键设置：

手动配置：

1. 在项目目录中创建配置文件：

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

2. 将以下内容添加到 .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

1. 打开 Claude Desktop 设置

   • 在 macOS 上：Cmd + ,
   • 在 Windows 上：Ctrl + ,

2. 转到“Developer”选项卡，然后点击“Edit Config”

3. 添加 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（预览版）

1. 创建 VS Code MCP 配置：

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

2. 将以下内容添加到 .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”

添加 API 密钥

无需 API 密钥，每天最多可发送 50 次请求。

在 IPLocate.io 注册免费 API 密钥，可将免费额度提高到每天 1,000 次请求。

注册免费 API 密钥

1. 访问 https://iplocate.io/signup
2. 创建免费账户
3. 在控制面板中获取 API 密钥

在此服务中使用 API 密钥

服务会自动从 IPLOCATE_API_KEY 环境变量读取 API 密钥。在 MCP 客户端设置中配置该变量（参见上面的配置示例），或在手动运行时设置。

手动运行服务

如果需要手动运行服务（用于开发或测试），有以下几种方式：

前置条件

• 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 响应格式

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
  }
  // ... and more fields
}

详情请参阅 IPLocate API 文档。

贡献

欢迎贡献！欢迎提交 Pull Request。

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

支持

• 如有此 MCP 服务相关问题，请在 GitHub 上提交 issue
• 如需 IPLocate API 支持，请联系 [email protected]
• 如需查看 IPLocate API 文档，请访问 https://iplocate.io/docs

致谢

• 感谢 Model Context Protocol 提供 MCP 规范
• 感谢 Anthropic 提供 MCP TypeScript SDK

关于 IPLocate.io

自 2017 年以来，IPLocate 一直致力于提供最可靠、最准确的 IP 地址数据。

我们处理 50TB 以上的数据，生成全面的 IP 地理位置、IP 所属公司、代理和 VPN 检测、托管检测、ASN 以及 WHOIS 数据集。我们的 API 每月处理超过 150 亿次请求，为数千家企业和开发者提供服务。

• 电子邮件：[email protected]
• 网站：iplocate.io
• 文档：iplocate.io/docs
• 注册免费 API 密钥：iplocate.io/signup