How do I install IP For AI?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does IP For AI need an API key?

No required environment variable is listed on this record.

What transport does IP For AI use?

IP For AI runs locally over stdio.

When was IP For AI last checked?

Last checked 2026-11-07. Check if your exit IP works for ChatGPT, Claude, Gemini: ASN, proxy/IDC type, risk, AI availability

IP For AI MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add cc.ipforai-ipforai -- npx -y ipforai-mcp@0.1.0

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "cc.ipforai-ipforai": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ]9    }10  }11}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

ipforai · AI 网络环境分与 IP 检测

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

面向 AI 访问场景，用 AI 网络环境分、出口 IP 画像、风险信号与服务连通性，帮助排查当前网络环境。官网覆盖 ChatGPT、Claude、Gemini、Grok，以及 DeepSeek、Kimi、豆包、通义千问、智谱清言、MiniMax、MiMo，共 11 家 AI 服务。

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

选择检测入口

入口	适用场景
网页版	查看 AI 网络环境分、IP 画像与浏览器侧连通性，并排查 WebRTC、双栈和分流出口
CLI	在终端或服务器检测本机出口、公开 AI 端点与分流路径；探测清单与浏览器版单独维护
JSON	程序查询出口画像、环境质量分及 AI 地区政策参考；不从指定 IP 发起实时连通探测
MCP	在 AI 客户端调用 JSON 画像查询，查看当前请求出口或指定 IP 的信息

一行命令

终端检测

快捷执行（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、时区、耗时和服务结果会随实际网络环境变化。

终端检测示例：出口总览与 AI 服务链路

终端检测示例：AI 分流出口与环境质量分

开发者 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 网络评分」徽章，点击回到官网结果页：

[](https://ipforai.cc/?ip=8.8.8.8)

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

[](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。

能做什么

能力	说明
出口画像	地理位置、ASN、网络类型、接入形态、路由属性
风险信号	代理相关风险档位、Tor 出口等（有数据时）
环境质量分	网络环境参考分，不是 AI 账号分
AI 可用性参考	服务端画像与地区政策参考：可用 / 受限 / 不可用 / 待确认；与本机端点实测分开解读
终端链路探测	CLI 在本机出口下探测公开入口与分流（指定 IP 时不跑链路）

明确不做什么

不判断账号是否会被封、能否登录、订阅是否有效
不提供「纯净度 / 防封 / 解锁」承诺
不把任意 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

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install IP For AI?

Does IP For AI need an API key?

What transport does IP For AI use?

When was IP For AI last checked?

Documentation

ipforai · AI 网络环境分与 IP 检测

选择检测入口

一行命令

终端检测

检测效果

开发者 JSON（GET）

README 徽章（GET）

MCP（AI 客户端）

能做什么

明确不做什么

依赖与边界

仓库结构

更新

谁在用（Used by）

License