mcp-server-iplocate

🚀 IPLocate.io IP地址地理位置和网络数据MCP服务器

IPLocate.io的MCP（模型上下文协议）服务器，为您提供全面的IP地址情报，包括地理位置、网络信息、隐私检测和滥用联系人等。

🚀 快速开始

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

配置您的MCP客户端

可用工具

服务器提供以下工具：

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或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密钥

1. 访问 https://iplocate.io/signup
2. 创建免费账户
3. 从仪表盘获取您的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
  }
  // ... 还有更多字段
}

有关完整详细信息，请参阅 IPLocate API文档。

贡献

欢迎贡献！请随时提交拉取请求。

支持

• 对于此MCP服务器的问题，请在GitHub上提交问题
• 对于IPLocate API支持，请联系 support@iplocate.io
• 对于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亿次请求。

• 电子邮件：support@iplocate.io
• 网站：iplocate.io
• 文档：iplocate.io/docs
• 注册免费API密钥：iplocate.io/signup

📄 许可证

本项目根据MIT许可证授权 - 有关详细信息，请参阅 LICENSE 文件。