SuperAPI AI 工具集

aiwen-mcp-server-geoip

埃文IP定位 MCP Server 是一个基于 Aiwen IP 定位 API 的 MCP 协议服务端,用于通过 IP 地址查询地理位置、运营商、AS 号、Whois、应用场景、风险画像、真假人及行业分类等信息。支持 IPv4 和 IPv6,地理位置查询可返回城市、区县、街道三种精度。核心工具包括 aiwen_ip_location、user_network_ip、ip_usage_scene、ip_whois_info、ip_as_mapping、ip_host_info、ip_risk_portrait、ip_identity_check 和 ip_industry_classify。使用时需配置 AIWEN_API_KEY 等环境变量。

访问官网

工具介绍

用途

埃文IP定位 MCP Server 是埃文科技推出的、已全面兼容 MCP 协议的 IP 定位 API 服务端。它面向需要通过 IP 地址获取地理位置及相关网络归属信息的应用场景,例如快速查询 IP 地理位置、网络安全与访问控制中验证 IP 来源、IP 地理位置相关的数据分析与科学研究,以及获取 IP Whois 信息的应用。

主要能力

该 MCP Server 提供以下工具:

  • IP定位(aiwen_ip_location):根据 IP 地址获取位置,支持城市、区县、街道三种精度,并返回经纬度、所属机构、运营商、精度等信息。参数为 ip(支持 IPv4、IPv6)。输出包括 continent、country、owner、isp、zipcode、timezone、accuracy、areacode、asnumber、lat、lng、prov、city、district、address。定位精度通过环境变量配置。
  • 获取当前网络IP地址和位置信息(user_network_ip):无参数,获取当前网络 IP 地址和位置信息,支持 IPv4 和 IPv6,输出结果同上。
  • IP应用场景(ip_usage_scene):根据 IP 地址获取应用场景,输出包括保留IP、未分配IP、组织机构、移动网络、家庭宽带、数据中心、企业专线、CDN、卫星通信、交换中心、Anycast 等场景,输出字段为 scene。参数支持 IPv4、IPv6。
  • IP Whois(ip_whois_info):根据 IP 地址查询 Whois 注册信息,获取 IP 所属网段范围、所属机构名称、技术联系人、管理员等信息。参数支持 IPv4,输出包括 netname、status、owner、techinfo、admininfo 等。
  • AS Whois(ip_as_mapping):查询 IP 地址 AS 号信息。参数支持 IPv4,输出包括 asname、asn、allocated、type、industry 等。
  • IP宿主信息(ip_host_info):根据 IP 地址查询 IP 的 AS Number、AS 名称、运营商、所属机构等归属属性。参数支持 IPv4,输出包括 asname、asnumber、isp、owner 等。
  • IP风险画像(ip_risk_portrait):根据 IP 地址获取风险画像,识别 VPN、代理、秒拨、数据中心、Tor 节点、端口扫描、暴力破解等高风险行为,输出风险评分、分级结果、IP 位置等信息。参数支持 IPv4,输出包括 tag、level、score 及位置场景信息 continent、country、prov、city、scene 等。
  • IP真假人(ip_identity_check):根据 IP 地址判断访问者是否为真实用户或机器流量,返回真人概率(real_person_rate)、秒播概率(mb_rate)等。参数支持 IPv4,输出包括 real_person_rate、mb_rate、asnumber、isp。
  • IPv4行业(ip_industry_classify):查询 IP 地址行业分类。参数支持 IPv4,输出为 industry。

接口的详细返回数据可参考官方 API 文档。

使用方式

使用前需要配置环境变量:

  • AIWEN_API_KEY:产品的 API KEY。
  • IPV4_ACCURACY:默认值为 city,用于配置 IPv4 定位精度,根据所购 API 版本选择一个值,可选 city(城市级)、district(区级)、street(街道级)。
  • IPV6_ACCURACY:默认值为 city,用于配置 IPv6 定位精度,根据所购 API 版本选择一个值,可选 city(城市级)、district(区级)、street(街道级)。

IP 定位产品分三个定位精度,通过上述环境变量配置:城市级最大定位精度返回到城市 city;区县级最大定位精度返回到区县 district;街道级最大定位精度返回到街道 address。

适用场景

需要快速查询 IP 地址地理位置的应用;网络安全和访问控制,验证 IP 来源;IP 地理位置相关的数据分析与科学研究;获取 IP Whois 信息的应用。

限制

部分工具(ip_whois_info、ip_as_mapping、ip_host_info、ip_risk_portrait、ip_identity_check、ip_industry_classify)参数仅支持 IPv4;aiwen_ip_location 和 user_network_ip 支持 IPv4 与 IPv6。定位精度取决于所购 API 版本,需通过环境变量选择对应精度。其他未提供的信息暂未提供。