Peer Glass

🔍 PeerGlass——互联网资源智能

PeerGlass Branding

协议说明： PeerGlass使用 RDAP （注册数据访问协议-- RFC 7480–7484）。RDAP（RFC 7480–7484）是IANA授权的JSON继承者 传统纯文本WHOIS。 你看到的地方 *“历史名人”* 在源代码或API响应中，即 RIPE-Stat自己的端点名称——这不是我们的协议选择。

查询全部 5个全球区域互联网注册机构 同时使用RDAP， 通过以下方式验证路线 资源公钥基础设施，检查 边界网关协议 路由可见性，跟踪已满 历史分配时间表，发现 IXP对等数据 通过PeeringDB， 和监视器 网络健康 -全部来自Claude中的自然语言或通过REST API。

______________________________________________________________________

5个RIR是什么？

把互联网的IP地址空间想象成一个全球土地登记处。 IANA（根）将大块委托给5个区域机构：

______________________________________________________________________

快速开始

安装

git clone https://github.com/duksh/peerglass
cd peerglass
pip install -e .

配置MCP客户端（Claude和其他人）

PeerGlass作为标准MCP stdio服务器运行(mcp.run() 在 server.py), 因此，任何兼容MCP的AI客户端都可以使用它，而不仅仅是Claude Desktop。

对于Claude Desktop，编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS） 或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "peerglass": {
      "command": "peerglass",
      "args": []
    }
  }
}

如果 peerglass 不在您的PATH中，请使用：

{
  "mcpServers": {
    "peerglass": {
      "command": "python",
      "args": ["/full/path/to/peerglass/server.py"]
    }
  }
}

重新启动克劳德桌面。全部 42工具 立即可用。

启动REST API

uvicorn api:app --host 0.0.0.0 --port 8000 --reload

交互式文档：http://localhost:8000/docs

启动Web UI

cd ui
npm install
npm run dev        # Dev server at http://localhost:5173

对于生产构建：

cd ui
npm run build      # Output in ui/dist/

集 VITE_API_BASE_URL 指向您的PeerGlass API部署：

VITE_API_BASE_URL=https://api.peerglass.io npm run build

______________________________________________________________________

示例查询（Claude中的自然语言）

第1阶段——注册表查找：

"Who owns the IP address 185.220.101.1?"
"What is the abuse contact for 8.8.8.8?"
"Who is AS13335 registered to?"
"Are all 5 RIR RDAP servers online right now?"

第2阶段——路由安全：

"Is the route 1.1.1.0/24 via AS13335 RPKI valid?"
"Is 8.8.8.0/24 currently visible in the global BGP table?"
"What prefixes is AS15169 (Google) announcing right now?"
"Find all internet resources registered to Cloudflare globally."

第三阶段——历史情报：

"Show me the full registration history of 8.8.8.0/24."
"Has the prefix 192.0.2.0/24 ever been transferred between organizations?"
"Give me the global IPv4 exhaustion stats for all 5 RIRs."
"Show me the prefix hierarchy for 1.1.1.0/24 — parent blocks and sub-assignments."

第4阶段——对等、IXP、健康和监测：

"Who does AS13335 (Cloudflare) peer with at internet exchanges?"
"List all IXPs where Google has a presence."
"Is the network for 1.1.1.0/24 currently healthy — any ROA issues or BGP anomalies?"
"Monitor AS13335 for changes since last baseline."

第5阶段——DNS智能：

"What DNS records does cloudflare.com have?"
"Is the DNSSEC chain valid for google.com?"
"Check if 1.2.3.4 is on any spam blocklist."
"Audit the email security posture of example.com."
"Has my DNS change for api.example.com propagated globally yet?"

第6阶段——TLS、证书和威胁情报：

"When does the TLS certificate for cloudflare.com expire?"
"Show me all certificates ever issued for *.example.com."
"Is 198.51.100.1 flagged as malicious — what ports and CVEs does Shodan see?"
"What hostnames has the IP 1.2.3.4 served historically?"

______________________________________________________________________

所有42个MCP工具

第1阶段——注册表查询

第2阶段——路由智能

第三阶段——历史情报

第4阶段——对等、IXP、健康和监控

第5阶段——DNS智能

第6阶段——TLS、证书和威胁情报

第7阶段——BGP深度

第8阶段——人道主义和危机情报

第9阶段——高级平台

______________________________________________________________________

REST API-41个端点

PeerGlass将每个工具都公开为REST端点，允许与 仪表板、脚本和CI/CD管道——不需要Claude。

注册表和路由

DNS智能

TLS、证书和威胁Intel

BGP深度

人道主义与危机

高级平台

快速示例：

# Look up who owns 1.1.1.1
curl http://localhost:8000/v1/ip/1.1.1.1

# Validate RPKI for Cloudflare's prefix
curl "http://localhost:8000/v1/rpki?prefix=1.1.1.0/24&asn=AS13335"

# Get BGP peers for Google
curl http://localhost:8000/v1/peering/AS15169

# List AFRINIC delegated IPv4 blocks (allocated + Ghana), paginated
curl "http://localhost:8000/v1/stats/ipv4?rir=AFRINIC&include_blocks=true&status=allocated&country=GH&limit=5&offset=0&format=json"

# DNS — enumerate all record types for a domain
curl http://localhost:8000/v1/dns/enumerate/cloudflare.com

# DNS — check email security (SPF/DMARC/DKIM)
curl http://localhost:8000/v1/dns/email/cloudflare.com

# DNS — check if an IP is on any blocklist
curl http://localhost:8000/v1/dns/dnsbl/1.2.3.4

# DNS — check propagation across 10 global resolvers
curl "http://localhost:8000/v1/dns/propagation/cloudflare.com?record_type=A"

# TLS — inspect certificate for a hostname
curl http://localhost:8000/v1/tls/cloudflare.com

# Certificates — find all certs ever issued for a domain
curl http://localhost:8000/v1/ct/cloudflare.com

# Threat intel — open ports, CVEs, risk score for an IP
curl http://localhost:8000/v1/threat/1.2.3.4

# Passive DNS — what hostnames has this IP served?
curl http://localhost:8000/v1/pdns/1.1.1.1

交互式文档（Swagger UI）：http://localhost:8000/docs

______________________________________________________________________

建筑

┌─────────────────────────────────────────────────────────┐
│                    PEERGLASS                            │
│                                                         │
│   Claude (LLM)              REST Clients                │
│       │ MCP / stdio              │ HTTP                 │
│       ▼                          ▼                      │
│   server.py (42 tools)      api.py (41 endpoints)       │
│       │                          │                      │
│       └──────────┬───────────────┘                      │
│                  ▼                                       │
│           rir_client.py  ── All async HTTP calls         │
│                  │                                       │
│       ┌──────────┼──────────────────┐                   │
│       ▼          ▼                  ▼                   │
│  normalizer.py  formatters.py    cache.py               │
│  (unify RDAP)   (markdown/JSON)  (TTL tiers)            │
│       │                                                  │
│       ▼                                                  │
│    models.py  (Pydantic v2 data models)                  │
└─────────────────────────────────────────────────────────┘

External APIs called at runtime:
  ├── RDAP:    rdap.afrinic.net / rdap.apnic.net / rdap.arin.net
  │            rdap.lacnic.net  / rdap.db.ripe.net
  ├── RPKI:    rpki.cloudflare.com
  ├── BGP:     stat.ripe.net (bgp-state, announced-prefixes,
  │            routing-status, asn-neighbours, historical-whois)
  ├── IXP:     peeringdb.com/api/net, /api/ix, /api/netixlan
  ├── Stats:   NRO Extended Delegation Stats (all 5 RIRs)
  └── Routing: data.iana.org/rdap/ (IANA bootstrap)

并行查询的工作原理

asyncio.gather() fires all 5 RIR queries at exactly the same time:

  AFRINIC ──── responds in 1.1s ──── 404 Not Found
  APNIC   ──── responds in 0.9s ──── ✅ 200 OK  ← authoritative
  ARIN    ──── responds in 1.2s ──── 404 Not Found
  LACNIC  ──── responds in 1.4s ──── 404 Not Found
  RIPE    ──── responds in 0.8s ──── 404 Not Found

Total wall-clock time: ~1–2s (parallel) vs ~6–8s (sequential)

______________________________________________________________________

Web用户界面（Sprint 7）

PeerGlass包括一个搜索优先、以暗终端为主题的web前端，该前端由 React 18+Vite 5+TypeScript+顺风CSS.

特性

• 自动检测：粘贴任何IP、ASN、前缀、域或2个字母的国家代码——UI会自动检测类型并运行正确的工具
• 7个工具类别：注册·路由·DNS·TLS·威胁·危机·对等
• 黑暗终端主题：深色背景，单空间字体（JetBrains Mono），青色/绿色重音调色板
• Markdown渲染：所有API结果呈现为带语法突出显示的格式化标记
• 危机控制面板：叙利亚、缅甸、乌克兰、白俄罗斯、伊朗、俄罗斯等国的一键式国家健康检查
• 41种工具可供使用：每个REST端点都通过UI公开

配置

目录结构

ui/
├── src/
│   ├── App.tsx                  # Main layout + tab state
│   ├── components/
│   │   ├── SearchBar.tsx        # Search input with auto-type detection
│   │   ├── ResultPanel.tsx      # Markdown result renderer
│   │   ├── TabBar.tsx           # Category + tool tab navigation
│   │   ├── StatusBadge.tsx      # RPKI/BGP/shutdown status indicators
│   │   └── CountryDashboard.tsx # Crisis country quick-access grid
│   ├── hooks/
│   │   └── usePeerGlass.ts      # Query state management hook
│   └── api/
│       └── client.ts            # Typed wrappers for all 41 endpoints
└── dist/                        # Production build output

______________________________________________________________________

测试

PeerGlass拥有 两个独立的测试套件 服务于不同的目的。 你应该同时运行这两个程序——它们捕获不同类别的问题。

┌─────────────────────────────────────────────────────────────┐
│                   TESTING PYRAMID                           │
│                                                             │
│      🔺 INTEGRATION TESTS  (test_integration.py)            │
│      /\   Real internet. Real APIs. Real data.              │
│     /  \  Proves the product actually works end-to-end.     │
│    /────\  Run this on your machine or a GCP VM.            │
│                                                             │
│   🔺 UNIT / STATIC TESTS  (test_peerglass.py)              │
│   /\   In-memory. No network. Instant.                      │
│  /  \  Proves code structure, branding, and wiring.         │
│ /────\  Runs anywhere including CI/CD.                      │
└─────────────────────────────────────────────────────────────┘

______________________________________________________________________

测试1--静态/单元测试(test_peerglass.py)

它检查什么：

如何跑步：

cd peerglass
python test_peerglass.py

预期产量：

============================================================
PEERGLASS — COMPLETE TEST SUITE
============================================================
1. COMPILE CHECK
   ✅ server.py  ✅ rir_client.py  ✅ formatters.py
   ✅ models.py  ✅ cache.py  ✅ normalizer.py  ✅ api.py

2. BRANDING AUDIT — no stale WHOIS identity strings
   ✅ server.py  ✅ rir_client.py  ✅ README.md  ...

...

✅ ALL TESTS PASSED — 0 errors
  Python files: 7  |  MCP tools: 42  |  REST endpoints: 41
  Protocol: RDAP throughout (RFC 7480-7484)
  Branding: PeerGlass throughout
============================================================

何时运行： 在每次承诺之前。运行时间不到3秒。不需要互联网。

______________________________________________________________________

测试2——集成测试(test_integration.py)

它检查什么：

使用以下命令对外部互联网注册表/数据提供商进行真正的HTTP调用 知名、稳定的测试夹具 （Cloudflare AS13335、谷歌AS15169、1.1.1.0/24）。每个测试都断言 实际响应数据——而不仅仅是服务器的响应。

如何跑步：

# On your local machine or a GCP VM (requires internet access)
cd peerglass
python test_integration.py

预期输出（通过）：

============================================================
  PEERGLASS — LIVE INTEGRATION TEST SUITE
  Real HTTP calls. No mocks. No fakes.
============================================================
  Time: 2026-02-20 14:00:00 UTC
  APIs: RIPE · ARIN · APNIC · LACNIC · AFRINIC · RIPE Stat · PeeringDB · IANA

────────────────────────────────────────────
  TEST 1 — RDAP Server Reachability (all 5 RIRs)
────────────────────────────────────────────
   ✅ PASS  RIPE RDAP reachable      HTTP 404
   ✅ PASS  ARIN RDAP reachable      HTTP 404
   ✅ PASS  APNIC RDAP reachable     HTTP 200
   ✅ PASS  LACNIC RDAP reachable    HTTP 404
   ✅ PASS  AFRINIC RDAP reachable   HTTP 404

...

============================================================
  SUMMARY
  Checks run   : 48
  ✅ Passed    : 47
  ❌ Failed    : 0
  ⚠️  Skipped  : 1
  Duration     : ~20-40s

  🎉 ALL TESTS PASSED — PeerGlass live APIs confirmed working!
============================================================

何时运行：

• 在发布之前
• 更改后 rir_client.py （HTTP层）
• 对外部API URL或参数进行任何更改后
• 按计划（例如GCP VM上的每日cron）检测上游API变化

为什么在没有配置的情况下无法在CI/CD中运行： 集成测试要求对外部API进行出站互联网访问 （RIPE、ARIN、APNIC、LACNIC、非洲、RIPE统计、PeeringDB、IANA）。标准CI运行程序（GitHub操作 免费版）可以上网，所以这些测试可以在那里运行。受限的 沙盒（拟人克劳德环境，一些公司代理）将被阻止 出站呼叫和每次测试都会失败 403 Forbidden --这是 沙盒的预期行为，而不是PeerGlass中的错误。

______________________________________________________________________

了解测试结果

为什么RDAP返回404仍然通过？

APNIC owns 1.1.1.0/24 (Cloudflare's block). If you ask RIPE for 1.1.1.1:

  You:  GET https://rdap.db.ripe.net/ip/1.1.1.1
  RIPE: HTTP 404

This 404 is RIPE saying "I know about this IP but it's not mine."
The server is alive and working correctly. 404 = server reachable.
200 = server reachable AND it's the authoritative RIR for that IP.
Both are valid success states for the reachability test.

为什么测试7有时会跳过？

RIPE统计 historical-whois 端点的覆盖范围是可变的。对于某些 ASN回归了丰富的历史；对于其他人来说 objects 数组为空。 空数组是有效的API响应-将记录跳过以区分 “API中的“无数据”已损坏。

______________________________________________________________________

同时经营两套套房

cd peerglass

# Step 1: Always run static tests first (fast, catches code errors)
python test_peerglass.py
echo "Exit code: $?"

# Step 2: Only run integration tests if static tests pass
if [ $? -eq 0 ]; then
    python test_integration.py
fi

______________________________________________________________________

验证——源锁定检索与模型召回

如果你想验证PeerGlass是确定性的，并且是源固定的 （真正的API检索），而不是模型调用，运行这个快速检查。

1. 要求ChatGPT获取所有5个RIR RDAP端点 1.1.1.1 并仅返回原始JSON。
2. 多次重复完全相同的提示。
3. 将ChatGPT输出与下面的直接端点结果进行比较。

在ChatGPT中使用此提示：

For IP 1.1.1.1, query these exact RDAP endpoints and return ONLY JSON:

- AFRINIC: https://rdap.afrinic.net/rdap/ip/1.1.1.1
- APNIC: https://rdap.apnic.net/ip/1.1.1.1
- ARIN: https://rdap.arin.net/registry/ip/1.1.1.1
- LACNIC: https://rdap.lacnic.net/rdap/ip/1.1.1.1
- RIPE: https://rdap.db.ripe.net/ip/1.1.1.1

Output schema per RIR:
{
  "rir": "...",
  "url": "...",
  "http_status": ...,
  "objectClassName": "... or null",
  "handle": "... or null",
  "error": "... or null"
}

Do not summarize. Do not infer.

地面实况脚本（直接端点调用）：

python - <<'PY'
import asyncio
import json
import httpx

ENDPOINTS = {
    "AFRINIC": "https://rdap.afrinic.net/rdap/ip/1.1.1.1",
    "APNIC": "https://rdap.apnic.net/ip/1.1.1.1",
    "ARIN": "https://rdap.arin.net/registry/ip/1.1.1.1",
    "LACNIC": "https://rdap.lacnic.net/rdap/ip/1.1.1.1",
    "RIPE": "https://rdap.db.ripe.net/ip/1.1.1.1",
}

async def query_one(client, rir, url):
    try:
        r = await client.get(url, timeout=20)
        content_type = r.headers.get("content-type", "")
        data = r.json() if "json" in content_type else {}
        return {
            "rir": rir,
            "url": url,
            "http_status": r.status_code,
            "objectClassName": data.get("objectClassName"),
            "handle": data.get("handle"),
            "error": None,
        }
    except Exception as exc:
        return {
            "rir": rir,
            "url": url,
            "http_status": None,
            "objectClassName": None,
            "handle": None,
            "error": str(exc),
        }

async def main():
    headers = {
        "Accept": "application/rdap+json",
        "User-Agent": "peerglass/verification",
    }
    async with httpx.AsyncClient(headers=headers, follow_redirects=True) as client:
        results = await asyncio.gather(*[
            query_one(client, rir, url) for rir, url in ENDPOINTS.items()
        ])
    print(json.dumps(results, indent=2))

asyncio.run(main())
PY

如果ChatGPT输出不一致或在直接调用稳定时无法获取， 这种差异正是PeerGlass使用确定性源锁定检索的原因。

______________________________________________________________________

添加自己的集成测试

这 test_integration.py 脚本被设计为可扩展的。每次测试如下 这种模式：

async def test_your_thing():
    section("TEST N — Short description")
    print("  What API, what fixture, what you expect")

    url = "https://example-api.com/endpoint"
    params = {"resource": "your-fixture", "sourceapp": "peerglass-test"}
    headers = {"Accept": "application/json", "User-Agent": "peerglass/1.0.0 (integration-test)"}

    try:
        async with httpx.AsyncClient(timeout=25.0) as client:
            resp = await client.get(url, params=params, headers=headers)

        if resp.status_code != 200:
            fail("API returned 200", f"HTTP {resp.status_code}"); return

        data = resp.json()
        value = data.get("some", {}).get("field", "")

        ok("Field is what I expected", f"value='{value}'") if value == "expected" else fail("Field check", f"Got '{value}'")

    except Exception:
        fail("API call failed", traceback.format_exc()[-120:])

然后将其添加到 main() 协程：

async def main():
    ...
    await test_your_thing()   # ← add here
    ...

______________________________________________________________________

使用的外部API

______________________________________________________________________

第3阶段数据源说明

RIPE统计历史人物

记录对RDAP对象所做的每一次更改：当组织字段更改时， 当状态改变时，当添加新的维护者时。被...使用 rir_prefix_history 和 rir_detect_transfers.名字 *“历史名人”* 是RIPE Stat自己的端点命名——PeerGlass始终使用RDAP协议。

新闻报道： 最适合RIPE NCC资源。部分适用于其他RIR。

RIPE统计数据分配历史

记录完整的分配生命周期：当块首次从 RIR池，当它被子分配给ISP时，当它返回时。

NRO扩展授权统计

每个RIR每天以管道分隔的文本文件形式发布。包含所有 有史以来创建的单个IP和ASN记录，以及当前状态。权威的 来源于 rir_ipv4_stats.

RIPE统计前缀概述/更少细节/更多细节

并行查询三个API，以构建前缀层次树 rir_prefix_overview.

______________________________________________________________________

用例工作流

BGP劫持调查

1. rir_query_ip(suspicious_ip)         → Who registered this IP?
2. rir_check_bgp_status(prefix)        → Which ASN is announcing it right now?
3. rir_check_rpki(prefix, asn)         → Is the announcement RPKI-valid?
4. rir_prefix_overview(prefix)         → Any unexpected more-specifics?
5. rir_detect_transfers(prefix)        → Did this block recently change hands?

并购尽职调查

1. rir_audit_org(company_name)         → What IP blocks does this company own?
2. rir_prefix_history(each_prefix)     → When were they acquired?
3. rir_detect_transfers(each_prefix)   → Were any transferred recently?
4. rir_get_announced_prefixes(asn)     → What are they actively routing?

对等和IXP分析

1. rir_get_peering_info(asn)           → Where does this network peer?
2. rir_lookup_ixps(city or ixp_name)  → Find IXPs in a region
3. rir_network_health(asn)             → Is the network healthy?
4. rir_change_monitor(asn)             → Any changes since last check?

政策研究/ISO报告

1. rir_ipv4_stats()                    → Full global IPv4/IPv6/ASN dashboard
2. rir_ipv4_stats(rir_filter="AFRINIC")→ Africa-specific detail
3. Compare ipv6_total_prefixes across  → IPv6 adoption rates by region

______________________________________________________________________

IPv4耗尽上下文

所有RIR现在都在转移政策下运作。IPv4地址交易 二级市场。 rir_ipv4_stats 实时跟踪剩余池。

______________________________________________________________________

许可证

麻省理工学院