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 批量 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 批量 IP 地理定位 API 查询多个 IP 地址。

Look up 8.8.8.8 8.8.6.6 9.9.9.9

MCP 服务器会检测多个 IP 地址，并在可能的情况下将其发送到 IP2Location.io 批量 API。

IP 地址可以用逗号、空格或换行符分隔。

[!NOTE]
访问 IP2Location.io 批量 IP 地理定位 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 批量 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 范围关联的区域互联网注册机构记录。

BGP 工具

当您需要以下信息时，BGP 查询镜和路由分析服务更为合适：

  • 路由通告
  • 前缀
  • BGP 路径
  • 对等互联
  • 路由变更
  • 当前由哪个 ASN 通告网络

IP 情报 API

当应用程序需要结合多个数据集的结构化信息时，IP 情报服务更受青睐，例如：

  • 地理定位
  • ASN
  • ISP
  • 代理检测
  • VPN 检测
  • 网络分类
  • 安全数据

对于希望在同一个工作流中获取地理定位和 ASN 信息的 MCP 用户，本项目提供了访问 IP2Location.io 的便捷接口。

了解 ASN 查询

自治系统编号（ASN） 用于标识自治系统：即在统一路由策略下运营的网络或 IP 前缀集合。

拥有 ASN 的组织示例包括：

  • 互联网服务提供商
  • 云托管提供商
  • 内容分发网络
  • 大学
  • 大型企业
  • 电信公司

在调查 IP 时，ASN 信息非常有用，因为它可以揭示哪个网络负责路由该地址。

例如：

8.8.8.8

与以下内容关联：

ASN: 15169
AS: Google LLC

ASN 查询通常用于：

  • 网络故障排除
  • 安全调查
  • 流量分析
  • 识别托管提供商
  • 按网络对流量进行分组
  • 调查可疑 IP 地址

IP 地理定位的准确性和局限性

IP 地理定位基于网络和 IP 分配信息提供 估计的地理位置。

它不应被视为用户或设备的精确物理位置。

准确性可能受到以下因素的影响：

  • VPN
  • 代理服务器
  • 移动网络
  • 企业网络
  • 运营商级 NAT
  • 卫星连接
  • 云基础设施
  • ISP 路由和地址分配变更

国家级别的结果通常比精确城市或坐标级别的结果更可靠。

请将 IP 地理定位用作上下文网络信息，而非精确的物理追踪。

IP2Location.io 套餐

返回的信息量取决于 IP2Location.io 套餐。

免费套餐提供基本的地理定位、基本 ASN 信息和基本的代理检测。

更高级的套餐可以提供额外信息，例如：

  • ISP
  • 域名
  • 网络速度
  • 使用类型
  • 移动网络信息
  • 详细的自治系统信息
  • 详细的代理信息
  • VPN 检测
  • Tor 检测
  • 数据中心检测
  • 威胁信息
  • 欺诈评分
  • 额外的地理定位属性

有关最新的查询限制、字段和定价，请参阅：

资源

许可证

请参阅 LICENSE.TXT 文件。