Ipforai MCP Server

ipforai 网络检测

English · 官网 · 命令行用法 · 检测方法

面向 AI 访问场景 的网络环境检测：当前出口画像、网络/接入/路由属性、风险信号、环境质量分，以及对 ChatGPT / Claude / Gemini 等服务的可用性参考（可用 / 受限 / 不可用 / 待确认）。

结果只描述网络环境，不代表账号登录、订阅资格或平台风控结论。

---

一行命令

终端检测

快捷执行（sh 和 bash 均可）：

curl -fsSL https://ipforai.cc/sh | sh
curl -fsSL https://ipforai.cc/sh | bash

先审阅再执行（推荐）：

curl -fsSL https://ipforai.cc/sh -o /tmp/ipforai-check.sh
less /tmp/ipforai-check.sh
sh /tmp/ipforai-check.sh -y
# 也可以用 bash 执行：bash /tmp/ipforai-check.sh -y

常用参数：

# 跳过确认
curl -fsSL https://ipforai.cc/sh | sh -s -- -y

# 指定 IP（仅画像与环境质量分，不含本机 AI 链路探测）
curl -fsSL https://ipforai.cc/sh | sh -s -- -y 8.8.8.8

# 详细输出
curl -fsSL https://ipforai.cc/sh | sh -s -- -y -d

以上命令中的 sh 均可替换为 bash；两者执行同一份 POSIX 兼容脚本。

权威脚本地址始终是官网 https://ipforai.cc/sh。本仓库中的 check.sh 为审阅镜像；请以官网版本为准。

完整参数、探测范围和结果解读见命令行检测指南。

检测效果

以下为脱敏的双栈终端检测示例。IP、时区、耗时和服务结果会随实际网络环境变化。

开发者 JSON（GET）

# GET /json：查看服务端看到的本次请求源 IP
curl -fsSL 'https://ipforai.cc/json'

# GET /json?ip=：服务端查询指定 IPv4 或 IPv6
curl -fsSL 'https://ipforai.cc/json?ip=8.8.8.8'
curl -fsSL 'https://ipforai.cc/json?ip=2001:4860:4860::8888'

# 强制分别查看请求的 IPv4 / IPv6 出口
curl -4 -fsSL 'https://ipforai.cc/json'
curl -6 -fsSL 'https://ipforai.cc/json'

# 使用 GET 参数编码传入 ip
curl --get -fsSL --data-urlencode 'ip=8.8.8.8' 'https://ipforai.cc/json'

ip 是唯一可选查询参数：省略或留空时查询本次请求源 IP；填入地址时只做服务端画像查询，不会从该 IP 发起实时连接，也不会读取调用方本机系统或浏览器数据。非法 IP 返回 HTTP 400。合法 ?ip= 响应带 Cache-Control: public, max-age=600，允许 CDN 缓存；无参响应始终 private, no-store。

字段说明见 docs/api.zh.md（English），示例响应见 examples/sample.json。

README 徽章（GET）

给任意项目 README 挂一张「AI 网络评分」徽章，点击回到官网结果页：

[![AI 网络评分](https://img.shields.io/endpoint?url=https%3A%2F%2Fipforai.cc%2Fbadge.json%3Fip%3D8.8.8.8)](https://ipforai.cc/?ip=8.8.8.8)

自托管 SVG（不依赖 Shields.io，任意网页 <img> 可直接嵌入）：

[![AI 网络评分](https://ipforai.cc/badge.svg?ip=8.8.8.8)](https://ipforai.cc/?ip=8.8.8.8)

实际效果（8.8.8.8 查询时的快照）：

README 徽章必须带 ?ip=：GitHub 的 README 图片由 camo 代理抓取并缓存，不带参数显示的是抓图方的分数，不是读者的。接口细节与颜色档位见 docs/badge.zh.md（English）。

MCP（AI 客户端）

在 Claude、Cursor 等支持 MCP 的客户端里直接问「我现在的 IP 能不能用 Claude」：

claude mcp add ipforai -- npx -y ipforai-mcp

提供 check_my_ip（本机出口）和 lookup_ip（指定 IP）两个工具，支持 HTTPS_PROXY。其他客户端的配置见 mcp/README.md。

---

能做什么

明确不做什么

• 不判断账号是否会被封、能否登录、订阅是否有效
• 不提供「纯净度 / 防封 / 解锁」承诺
• 不把任意 IP 的字符串当成「从该 IP 真实访问 AI」的连通探测（指定 IP 只查画像）

---

依赖与边界

• CLI：POSIX sh、curl 和系统常用命令；只读检测，不写系统配置、不安装软件、不需要 API Key
• 网络请求：CLI 会向 ipforai.cc、IPv4 探测域名及脚本列出的 AI/厂商公开域名发起探测；JSON 只请求官网后端画像接口
• 数据来源：离线库与规则由官网维护，仓库中的 check.sh 只是审阅镜像
• 会创建临时目录并在退出时删除
• 一次 TCP 请求只能看到一个源地址族；双栈请 -4 / -6 各查一次

---

仓库结构

.
├── README.md / README_EN.md
├── LICENSE
├── check.sh                 # /sh 的审阅镜像，以官网为准
├── docs/api.zh.md / api.md  # /json 说明
├── docs/badge.zh.md / badge.md  # /badge.json、/badge.svg 说明
├── mcp/                     # MCP 服务（npm 包 ipforai-mcp）
└── examples/sample.json     # 示例响应（单次请求仅一侧有值）

更新

• 脚本版本以运行输出中的版本号及响应头 X-IP-for-AI-Check-Version 为准（当前镜像：v2.1）
• JSON 模式：X-IP-for-AI-Schema: json-v1；单次 /json 只填一个地址族，dualStack 多为 false
• 更新镜像：curl -fsSL https://ipforai.cc/sh -o check.sh

谁在用（Used by）

如果你的项目把 ipforai 接进来了——README 徽章、/json?ip= 接口或 CLI 检测——欢迎开一个 issue 告知，我们会把你列在这里：

暂无。欢迎成为第一个。

集成前请阅读 JSON 接口说明 中的「稳定性承诺」与「跨域（CORS）」：?ip= 对任意来源开放，无参形式不对第三方站点开放跨域。

---

License

MIT