IP Judge

org.ipjudge由 ipjudge.org 发布官方发布者v1.0.2更新于 Nov 2, 2026

Check an IP or your own network exit before using ChatGPT, Claude, Gemini or Meta Muse.

已验证Streamable HTTP可网页运行云端与基础设施安全与监控

概览

AI 生成的概览

远程 IP Judge 服务,让助手检测 IP 或自身网络出口是住宅还是机房、地区是否被 AI 平台支持,并查询服务状态。

可以做什么
  • 判定任意 IPv4/IPv6 地址:住宅或机房、0–100 纯净度、风险名单命中,以及 ChatGPT、Claude、Gemini、Muse 是否接受其地区与类型
  • 判定发起 MCP 请求那台机器的公网出口 IP,看该网络是否会被接受
  • 查询某个国家或地区是否在 ChatGPT、Claude、Gemini、Muse 的官方支持名单中
  • 查询 Claude、OpenAI、Cursor、GitHub、Cloudflare 等的官方实时状态,每 3 分钟刷新
适用场景
适合想弄清 AI 服务为何拒绝或限制连接时使用:在使用 ChatGPT、Claude、Gemini 或 Muse 前检查代理或 VPS 出口、确认某地区是否被官方支持,或核实某服务商当前是否故障。
运行要求
远程 Streamable HTTP 端点 ipjudge.org/mcp,无需密钥。匿名使用每访客每 10 分钟最多 40 次新查询;更多需在 Authorization Bearer 头中提供 API key。需要能访问 ipjudge.org 及各平台公开状态页。
安装前请注意
服务器会看到发起请求那台机器的公网 IP,网页版 connector 看到的是平台服务器出口而非你的。结果只是观测事实,不预测账号或 API 调用是否成功。不建议批量扫描,展示结果应注明数据来自 ipjudge.org。可选的 API key 属于需保密的凭据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 IP Judge,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/org.ipjudge%2Fipjudge/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "ip-judge": {
      "type": "http",
      "url": "https://ipjudge.org/mcp"
    }
  }
}

README

IP 判官 · IP Judge

ipjudge.org —— 中立的 IP / 网络出口检测。用 ChatGPT、Claude、Gemini、Meta Muse 之前,先看清你的出口:住宅还是机房、地区是否受官方支持、有没有 DNS / WebRTC 泄露、终端和浏览器是不是走的同一条线路。

English

这个仓库放的是会在你机器上运行的部分,方便你在 curl | bash 之前先读源码:

文件作用一行运行
scripts/cc.shClaude Code / Codex 终端出口体检curl -sL ipjudge.org/cc | bash
scripts/check.sh服务器(VPS)一键体检bash <(curl -Ls ipjudge.org/sh)
server.jsonMCP 服务描述(官方 MCP Registry:org.ipjudge/ipjudge)见下文

两个脚本都是只读的:不安装任何东西、不改设置、不上传数据。发往 ipjudge.org 的请求只有一个:查询本机出口 IP 的判定(和你直接打开网站一样)。其余请求直接访问各平台的公开地址。

本仓库的脚本与线上同步更新,但线上发布并不由本仓库自动触发,二者可能短暂不一致。运行前请自己核对:

bash
diff <(curl -sL ipjudge.org/cc) scripts/cc.sh && echo 一致

有输出就说明线上版本比仓库新(或相反),以你实际读过的那一份为准;欢迎在本仓库开 issue。

终端出口体检(Claude Code / Codex)

Claude Code、Codex 跑在终端里,只认 HTTPS_PROXY 这类环境变量,不一定走浏览器用的代理。浏览器检测显示美国住宅,终端却可能直连出去。

bash
curl -sL ipjudge.org/cc | bash          # 中文curl -sL ipjudge.org/en/cc | bash       # English

按 Claude Code 官方规则判断代理:只认 https_proxy / HTTPS_PROXY / http_proxy / HTTP_PROXY 和 ~/.claude/settings.json 里的 env;不支持 SOCKS;官方文档只列了上面四个变量,没有提到 ALL_PROXY(官方文档)。

Agent Skill:在 Claude Code / Codex 里直接自检

skills/ipjudge-exit-check 是一个遵循 Agent Skills 规范 的技能:装好后,对 agent 说「帮我查一下终端出口」,它会运行内置的 exit-check.sh 并用大白话解释结果。

bash
# Claude Code(装到 ~/.claude/skills/)DO_NOT_TRACK=1 npx --yes skills add ipjudge/ipjudge --skill ipjudge-exit-check --global --agent claude-code --copy --yes# Codex / Cursor / GitHub Copilot / OpenCode(装到 ~/.agents/skills/)DO_NOT_TRACK=1 npx --yes skills add ipjudge/ipjudge --skill ipjudge-exit-check --global --agent codex --copy --yes

一定要带 --agent:不带的话安装器会把它复制进几十个不同工具的目录。

  • 只读:不改任何设置、不装东西。代理变量只报名称和形态,不打印地址、账号密码或 NO_PROXY 内容;不读 settings.json 的值。
  • 只往外发一次查询:把出口 IP 发给 ipjudge.org 取判定,其余请求是各平台公开的 /cdn-cgi/trace。
  • 只陈述观测到的事实:能看出「某个域名看到的是哪个 IP、哪个国家」,看不出账号、登录或 API 会不会成功,也不预测任何账号的结果。检查没跑完时会明确标「不完整」,不会说「没问题」。
  • 需要 bash 3.2+ 和 curl(macOS / Linux / WSL);原生 Windows 请用网页版。
  • 安装器自带的统计请求用 DO_NOT_TRACK=1 关闭;脚本本身没有任何统计。
  • 测试:tests/run_tests.sh(全部使用本机假服务,不联网)。

MCP(给 AI Agent 用)

端点:https://ipjudge.org/mcp(Streamable HTTP,免费,不需要 key)

bash
# Claude Codeclaude mcp add --transport http ipjudge https://ipjudge.org/mcp
json
// Cursor / Windsurf / 其他支持远程 MCP 的客户端{ "mcpServers": { "ipjudge": { "url": "https://ipjudge.org/mcp" } } }
工具说明
my_exit判定发起 MCP 请求的那台机器的出口。Claude Code、Cursor 等本机客户端就是你的电脑;网页版 connector 由平台服务器发起请求,看到的是平台服务器的出口
check_ip判定任意 IPv4 / IPv6:住宅 / 机房、纯净度 0–100、风险名单命中、四家 AI 是否接受
ai_availability某国家 / 地区是否在 ChatGPT、Claude、Gemini、Muse 的官方支持名单里
service_statusClaude、OpenAI、Cursor、GitHub、Cloudflare 等的官方实时状态

不带 key 时每个访客 10 分钟最多 40 次新查询;需要更多,在 我的账户 创建 API key,加 --header "Authorization: Bearer ipj_你的key"。

HTTP API

bash
curl ipjudge.org/api/ip/8.8.8.8                       # JSON,无需 keycurl -H "Authorization: Bearer ipj_你的key" "https://ipjudge.org/api/v1/ip/8.8.8.8"

字段说明和配额见 ipjudge.org/tools/api/。展示结果时请注明「数据来自 ipjudge.org」并附链接;请勿批量扫描。

判定规则

规则全部公开:ipjudge.org/method/。觉得判错了,到 纠错页 提交,或在本仓库开 issue。


English

ipjudge.org is a neutral IP / network-exit checker. Before you use ChatGPT, Claude, Gemini or Meta Muse, see what your exit really looks like: residential or datacenter, whether the region is officially supported, DNS / WebRTC leaks, and whether your terminal takes the same route as your browser.

This repository holds the parts that run on your machine, so you can read them before piping to bash:

  • scripts/cc.sh — Claude Code / Codex terminal exit check: curl -sL ipjudge.org/en/cc | bash
  • scripts/check.sh — server (VPS) check: bash <(curl -Ls ipjudge.org/en/sh)
  • server.json — MCP server description, listed in the official MCP Registry as org.ipjudge/ipjudge

Both scripts are read-only: they install nothing, change nothing and upload nothing. The only request to ipjudge.org asks for the verdict on your own exit IP.

The terminal check follows Claude Code's documented proxy rules: only https_proxy / HTTPS_PROXY / http_proxy / HTTP_PROXY and the env block in ~/.claude/settings.json. SOCKS is not supported and ALL_PROXY is not read (docs).

MCP

Endpoint https://ipjudge.org/mcp (Streamable HTTP, free, no key needed):

bash
claude mcp add --transport http ipjudge https://ipjudge.org/mcp

Tools: my_exit (the exit of whichever machine sends the MCP request — your computer for Claude Code / Cursor; the platform's servers for web connectors), check_ip, ai_availability, service_status. Without a key: 40 new lookups per visitor per 10 minutes. For more, create a key under My account and send Authorization: Bearer ipj_YOURKEY.

API, rules and corrections

License: MIT

来源:README.md,提交 cf0381f

工具

4

check_ip

Judge an IPv4/IPv6 address: residential vs datacenter, purity score 0-100, risk-list hits, and whether ChatGPT, Claude, Gemini and Muse accept its region/type. Data: ipjudge.org.

输入参数ip必填lang

my_exit

Judge the public IP this agent/server is calling from (its own network exit) — use it to check whether Claude / ChatGPT will accept the machine the agent runs on.

输入参数lang

ai_availability

Whether ChatGPT, Claude, Gemini and Muse officially support a country (ISO 3166-1 alpha-2, e.g. US, HK, CN), from each company's published list.

输入参数country必填

service_status

Official live status (Statuspage) of Claude, OpenAI, Cursor, GitHub, Cloudflare and more, refreshed every 3 minutes.

输入参数service

版本历史

2
  1. v1.0.2最新Oct 5, 2026
  2. v1.0.1Sep 30, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分