Address Validator

Name: Address Validator
Author: Kder974

作者：Kder974版本 1.0.1i★ 0i在云端运行

注册名称io.github.Kder974/address-validator

安装方法

What it does

Valide une adresse de livraison : normalisation, geocodage, score de livrabilite. x402.

Connects 在云端运行
Account or key No key needed
Category 其他

安装

选择你使用的 AI 应用，然后复制设置。

通过 5/5 项检查 · 你的提问会经过开发者的服务器（kder-ai.com） · ✓ 命令已检查 2026年11月13日

第一步：你用哪个 AI？

Claude网页 · 应用 · 手机ChatGPT网页Claude Code终端Cursor代码编辑器VS Code代码编辑器其他其他应用

选择你用的应用，步骤会显示在下方。

可连接 Claude · 约 2 分钟

不需要密钥，不用安装程序 · 在 claude.ai 或桌面应用设置一次，即可在聊天中使用 · 免费账户可添加 1 个 · Team/Enterprise 方案由所有者（Owner）添加

打开 Claude 的 Connectors 页面
CustomizeConnectors
已完成
点击“Add” → “Custom” → “Web”，填写这 2 项
把这里的内容复制到 Claude 中同名的输入框，然后点击 Continue
Name · 名称Address Validator
Remote MCP server URL · 地址https://kder-ai.com/mcp
在 Claude 检测到的登录设置页点击 Continue · Authentication 按作者说明选择（Sign in now、Sign in when needed 或 No sign in），然后点击 Add
已完成
在聊天中开启
+ConnectorsAddress Validator
已完成
试一试
用 Address Validator 告诉我你能帮我做什么，然后做一件给我看
✓ 如果 Claude 说正在使用 Address Validator，或回答中出现 Address Validator 的工具名称，就表示连接成功

菜单名称已于 2026年11月11日对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

能否连接 ChatGPT 取决于方案

完整 MCP：网页版 ChatGPT Business、Enterprise 或 Edu · Pro：以读取/获取权限连接，修改数据的工具可能用不了 · Plus：官方文档尚未确认，如果在插件页看到添加自定义 MCP 的选项可以试试 · 仅限网页

在网页版 ChatGPT 打开添加 MCP 的页面
Plugins+Add custom MCP server
已完成
填写名称和地址
输入名称，在 Connection 下粘贴地址，勾选风险提示，然后点击 Create as a plugin
Name · 名称Address Validator
Connection · 地址https://kder-ai.com/mcp
已完成
在聊天中选择 Address Validator
开启新聊天，输入前先从插件列表中选择 Address Validator
已完成
试一试
用 Address Validator 告诉我你能帮我做什么，然后做一件给我看
✓ 如果 ChatGPT 说正在使用 Address Validator，或回答中出现 Address Validator 的工具名称，就表示连接成功

菜单名称已于 2026年11月11日对照 OpenAI 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Claude Code · 约 2 分钟

不需要密钥，不用安装程序

打开终端
Mac：按 Command+空格，输入 Terminal · Windows：打开 PowerShell
已完成

粘贴这条命令并按 Enter

claude mcp add --transport http --scope user address-validator https://kder-ai.com/mcp

已完成

在 Claude Code 中输入 /mcp
应能看到 Address Validator 在列表中并显示已连接
已完成
试一试
用 Address Validator 告诉我你能帮我做什么，然后做一件给我看
✓ 如果 Claude Code 说正在使用 Address Validator，或回答中出现 Address Validator 的工具名称，就表示连接成功

菜单名称已于 2026年11月11日对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Cursor · 约 2 分钟

不需要密钥，不用安装程序

点击这个按钮打开 Cursor
在 Cursor 中打开
Cursor 会请你确认安装，点击 Install
已完成
在 Cursor 中以 Agent 模式打开 AI 聊天
已完成
试一试
用 Address Validator 告诉我你能帮我做什么，然后做一件给我看
✓ 如果 Cursor 说正在使用 Address Validator，或回答中出现 Address Validator 的工具名称，就表示连接成功

菜单名称已于 2026年11月11日对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同

可连接 VS Code · 约 2 分钟

不需要密钥，不用安装程序

点击这个按钮打开 VS Code
在 VS Code 中打开
VS Code 会请你确认安装，点击 Install
已完成
在 VS Code 中以 Agent 模式打开 AI 聊天
已完成
试一试
用 Address Validator 告诉我你能帮我做什么，然后做一件给我看
✓ 如果 VS Code 说正在使用 Address Validator，或回答中出现 Address Validator 的工具名称，就表示连接成功

菜单名称已于 2026年11月11日对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同

其他支持 MCP 的应用（如 Windsurf、Zed、Gemini CLI）添加方式各不相同，请在应用列表中查看

查看所有支持 MCP 的应用 →

通过网页连接的应用使用的地址

地址https://kder-ai.com/mcp

JSON 设置在下方“开发者专用”中

卡住了？问问正在用 Address Validator 的人💬 讨论 →

开发者专用：终端命令和 JSON 设置

通过网页连接

Claude Code

claude mcp add --transport http --scope user address-validator https://kder-ai.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "address-validator": {
      "url": "https://kder-ai.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "address-validator": {
      "type": "http",
      "url": "https://kder-ai.com/mcp"
    }
  }
}

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

一览

GitHub 星标 i: 0
每周下载量i: 不在 npm/PyPI 上
许可证 i: MIT
连接方式: 在云端运行
传输方式: streamable-http
最新版本i: 1.0.1
分类i: 其他
发布到注册中心i: 2026年10月21日
代码最后更新i: 2026年11月5日
作者: Kder974
仓库: Kder974/address-validator
网站: kder-ai.com
注册状态: 活跃

哪些应用可以使用它

依据这个服务器的连接方式和各应用自己的文档，检查于 2026年11月10日。

通过互联网连接，适用于

Claude ChatGPT Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Open WebUI Raycast

全部应用及其优缺点 →

它能做什么

工具名称和描述与服务器在 2026年11月12日报告的完全一致。这些内容由作者撰写，不是我们写的；我们以纯文本形式显示。

validate_address
Valide une adresse de livraison et renvoie sa forme standardisee, ses coordonnees et un score de livrabilite (residential / commercial / unknown / invalid) avec un niveau de confiance. Une reponse 200 avec degraded=true signale que le fournisseur etait injoignable : la reponse es

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月13日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 Kder974 验证，该账户拥有此仓库
✓ 通过
仍在维护
代码最后更新于8天前
✓ 通过
有许可证
使用 MIT
✓ 通过
端点有响应
在 501 毫秒内响应（HTTP 200）
– 不适用
使用 OAuth 登录
无需登录
✓ 通过
工具描述中没有隐藏指令
已读取 1 个工具描述，未发现针对 AI 的隐藏指令

讨论

提问、分享技巧或报告无法使用。按“有帮助”数量排序。

还没有帖子，欢迎第一个提问或分享。

此处内容由用户撰写，不代表 PopNx 团队。

使用 Google 登录后发帖

用户评价

还没有评价

用 Google 登录后写评价

与“其他”中的其他服务器比较i

星标数多于此分类中其他 19675 个服务器的 0%
发布到注册中心的时间比此分类中其他 19675 个服务器的 64% 更新
基础检查结果等于或优于此分类中其他 19675 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

Address Validator 安全吗？

它在 5 项适用的基础检查中通过了 5 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

注册中心没有列出必需的密钥，不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端？

它在作者的云端运行。通过互联网连接，无需安装，但你发送的内容会经过作者的服务器。

它还在维护吗？

GitHub 仓库最后更新于8天前，最新版本（1.0.1）于23天前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。它通过 URL 连接，因此也能用于接受远程 MCP 的应用，例如网页版 ChatGPT（Business 及以上为完整 MCP；Pro 为只读）。

有什么可以替代它？

同一分类中有：World Monitor, Claude Flow, Windmill

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

Address Validator API

API HTTP payante à la requête (protocole x402, prix par défaut 0.02 USDC) qui prend une adresse de livraison brute et renvoie une adresse standardisée, ses coordonnées, un score de livrabilité et une clé de cache.

1. Présentation

Entrée unique payante : POST /validate — refuse en 402 Payment Required tant qu'aucune preuve de paiement valide n'est fournie.
Sortie : adresse standardisée (line1, line2, city, state, zip, country), corrigée par le fournisseur quand l'adresse est reconnue (D84 : orthographe, ville, code postal ajouté), latitude/longitude (géocodage Nominatim), deliverability, confidence, degraded et cache_key.
Découverte : GET /manifest décrit le service et son schéma pour un annuaire x402 / MCP.
Résilience : si le fournisseur est injoignable, l'API répond quand même 200 avec degraded: true — jamais une erreur qui laisserait croire à une adresse invalide certaine.

Critères de succès de la spec, et où ils sont vérifiés automatiquement :

#	Critère	Vérification
1	Un appel sans preuve reçoit `402` (prix et protocole annoncés)	`tests/test_payment.py` (8 tests), `tests/test_routes_extra.py::test_metrics_count_unpaid_requests`, `scripts/e2e_check.py`
2	Un appel avec preuve valide reçoit `200` et le résultat	`tests/test_cache.py` (appels payants réels), `tests/test_validation.py::test_valid_address_with_mocked_provider`, `scripts/e2e_check.py`
3	Le cache évite de rappeler le fournisseur sur une adresse répétée	`tests/test_cache.py::test_second_identical_request_hits_cache` et `::test_distinct_requests_call_provider_twice`, `scripts/e2e_check.py`
4	Une panne fournisseur produit une réponse dégradée rapide et explicite	`tests/test_validation.py::test_degraded_flag_set_when_provider_unreachable`, `tests/test_circuit_breaker.py`, `tests/test_latency_budget.py`

Ce que ce service ne fait pas : aucun rate limiting applicatif (D21) — la limite est tenue au niveau *edge* par Nginx (nginx-hardening.conf : 10 requêtes/s par IP, rafale 20, 429 au-delà). Le paiement hérité (preuve HMAC à secret partagé, D15) n'est plus accepté sur sa seule signature : depuis le durcissement W1 (12/10/2026), la confirmation on-chain (D27) est active par défaut et exige, sur Base, un transfert USDC confirmé vers le portefeuille d'encaissement. Une preuve HMAC synthétique n'obtient un 200 que dans une recette déclarée (TEST_MODE=true), et la ligne écrite est alors marquée test_mode, donc exclue du revenu réel (D40). Tout est documenté (README.md §7 et §9, SECURITY.md §3 et §6, AUDIT_TRAFIC_VPS.md §5) plutôt que passé sous silence.

2. Démarrage rapide

Prérequis : Python 3.12 (le venv du dépôt tourne en 3.12.10, comme l'image python:3.12-slim du Dockerfile). PostgreSQL et Redis sont facultatifs : sans eux, l'API démarre et se dégrade proprement (/health le dit).

# 1. Environnement virtuel

py -3.12 -m venv .venv .\.venv\Scripts\python.exe -m pip install -r requirements.txt -r requirements-dev.txt

2. Configuration (jamais de secret dans le dépôt)

Copy-Item .env.example .env # renseigner SMARTY_AUTH_ID / API_SECRET_KEY / clés CDP

3. Lancer l'API

.\.venv\Scripts\python.exe -m uvicorn app.main:app --reload --port 8000

# Vérifications

.\.venv\Scripts\python.exe -m pytest -q # suite complète .\.venv\Scripts\python.exe scripts\run_tests.py # oracle de tests (rapport JUnit) .\.venv\Scripts\python.exe scripts\doc_check.py README.md 10 # sections de ce fichier .\.venv\Scripts\python.exe scripts\e2e_check.py http://127.0.0.1:8000 # recette bout-en-bout

Démarrage conteneurisé : docker compose up -d (voir docker-compose.yml et Dockerfile).

Déploiement en production (VPS Debian 12, Nginx + HTTPS, paiement x402) : `DEPLOIEMENT_VPS.md` — compte rendu réel, écarts assumés par rapport au plan et points de vigilance d'exploitation.

3. Configuration

Toutes les valeurs viennent de l'environnement ou de .env (pydantic-settings, app/config.py). Une variable inconnue est ignorée (décision D8).

Champ	Variable	Défaut	Rôle
`api_host` / `api_port`	`API_HOST` / `API_PORT`	`127.0.0.1` / `8000`	écoute uvicorn (`127.0.0.1` : le service est publié par Nginx, pas directement)
`api_secret_key`	`API_SECRET_KEY`	`change_me`	clé HMAC de la preuve de paiement — à changer impérativement
`database_url`	`DATABASE_URL`	`postgresql://user:password@localhost:5432/address_validator`	PostgreSQL (journal des paiements)
`redis_url`	`REDIS_URL`	`redis://localhost:6379/0`	cache des résultats
`smarty_auth_id` / `smarty_auth_token`	`SMARTY_AUTH_ID` / `SMARTY_AUTH_TOKEN`	vide	identifiants du fournisseur de validation
`cdp_api_key_id` / `cdp_api_key_secret`	`CDP_API_KEY_ID` / `CDP_API_KEY_SECRET`	vide	SDK Coinbase CDP (facultatif)
`cdp_wallet_address`	`CDP_WALLET_ADDRESS`	vide	portefeuille annoncé dans le `402`
`x402_price`	`X402_PRICE`	`0.02`	prix par validation, en USDC
`x402_onchain_verify`	`X402_ONCHAIN_VERIFY`	`true`	confirmation on-chain du transfert USDC (D27, active par défaut depuis W1) — `false` n'est admis qu'avec `TEST_MODE=true` ; hors recette, toute preuve à secret partagé est alors refusée — voir §7
`base_rpc_url`	`BASE_RPC_URL`	`https://mainnet.base.org`	nœud JSON-RPC Base (chaîne 8453) utilisé quand D27 est actif
`x402_usdc_contract`	`X402_USDC_CONTRACT`	`0x833589…4bda02913`	contrat USDC natif de Base
`x402_min_confirmations`	`X402_MIN_CONFIRMATIONS`	`1`	confirmations minimales exigées avant d'accepter le paiement
`x402_network` / `x402_chain_id`	`X402_NETWORK` / `X402_CHAIN_ID`	`base` / `8453`	reseau et chaine annonces dans `accepts[]`
`x402_domain_name` / `x402_domain_version`	`X402_DOMAIN_NAME` / `X402_DOMAIN_VERSION`	`USD Coin` / `2`	domaine EIP-712 du jeton - verifie on-chain par `scripts/test_x402_payment.py --check-domain`
`x402_facilitator_url`	`X402_FACILITATOR_URL`	`https://api.cdp.coinbase.com/platform/v2/x402`	facilitateur (`/verify` puis `/settle`)
`x402_facilitator_verify`	`X402_FACILITATOR_VERIFY`	`true`	appel de `/verify` avant le reglement
`x402_require_settlement`	`X402_REQUIRE_SETTLEMENT`	`true`	ne rendre le service qu'apres encaissement (`false` = jamais en production)
`public_base_url` / `mcp_public_url`	`PUBLIC_BASE_URL` / `MCP_PUBLIC_URL`	`https://kder-ai.com` / `.../mcp`	URLs publiees dans `accepts[].resource`, la carte MCP et les annuaires
`discovery_log_*`	`DISCOVERY_LOG_ENABLED`, `DISCOVERY_LOG_PATH`, `DISCOVERY_LOG_RAW_IP`, `DISCOVERY_LOG_SALT`, `DISCOVERY_LOG_RETENTION_DAYS`	journal actif, chemin vide (journald), IP pseudonymisee, 30 j	journal des refus `402` et retention appliquee (`PRIVACY.md` 3)
`dashboard_user` / `dashboard_password`	`DASHBOARD_USER` / `DASHBOARD_PASSWORD`	`kder` / vide	`/dashboard` - vide = endpoint ferme (`503`) ; `LOGIN_MAX_FAILURES` mots de passe faux par IP bloquent `LOGIN_LOCK_MINUTES` min (D67)
`geoip_db_path` / `audience_retention_days`	`GEOIP_DB_PATH` / `AUDIENCE_RETENTION_DAYS`	`/var/lib/address-validator/dbip-country.mmdb` / `400`	suivi d'audience (D67) : base des pays DB-IP Lite posée par `scripts/maj_geoip.sh` (absente = pays inconnu) ; conservation des lignes `page_visits` et `api_calls`
`pilotage_comptes`	`PILOTAGE_COMPTES`	vide	comptes du tableau de bord (D74), « Nom=email » séparés par des virgules ; jamais dans le code (dépôt public)
`cost_server_eur` / `cost_smarty_eur` / `cost_smarty_per_call_usd` / `cost_mail_eur`	`COST_SERVER_EUR` / `COST_SMARTY_EUR` / `COST_SMARTY_PER_CALL_USD` / `COST_MAIL_EUR`	`0`	coûts lus par le tableau de bord (D68) : tous à `0` = résultat du mois non calculé
`test_mode` / `test_mode_cutoff_utc`	`TEST_MODE` / `TEST_MODE_CUTOFF_UTC`	`false` / `2026-10-11T12:00:00+00:00`	une transaction marquée `test_mode` est un essai de recette : exclue de `real_`, comptée dans `test_` et `total_*` (D40)
`environment` / `log_level`	`ENVIRONMENT` / `LOG_LEVEL`	`development` / `INFO`	contexte et verbosité

4. Endpoints et contrat de données

Méthode	Chemin	Rôle	Source
`GET`	`/`	identité du service et liens	`app/main.py:57-65`
`GET`	`/manifest`	description x402 (prix, devise, schémas)	`app/routes/manifest.py`
`GET`	`/health`	état réel de PostgreSQL et Redis, borné à 2 s	`app/routes/health.py`
`GET`	`/metrics`	compteurs, état du disjoncteur, état du cache	`app/routes/metrics.py`
`GET`	`/metrics/revenue`	revenu agrégé 24 h / 7 j / 30 j — `real_` hors recette, `total_` registre entier (D40) — et disponibilité du registre	`app/routes/revenue.py`
`GET`	`/dashboard`	tableau de bord d'exploitation — privé (Basic Auth ; `503` si `DASHBOARD_PASSWORD` est absent ; 5 mots de passe faux par IP bloquent 15 min, D67) ; depuis D67, chaque visite d'une page publique et chaque appel d'API laissent une ligne de suivi (pays, origine, durée, statut ; ni IP ni cookie) ; depuis D69, dessin v2 (barre latérale, grande carte du résultat, carte du monde en points, Site et SEO avec sources, robots et pages, parcours visite → payant) ; depuis D68, écrans argent (encaissé réel, abonnements à facturer, coûts, résultat, prévision, revenu par pays et par canal), API (statuts, temps de réponse, cache, canaux, pays) et clients (essais qui finissent, quotas, jamais appelé), alertes, périodes `?p=jour	7j	30j	mois`, rafraîchie chaque minute	`app/routes/dashboard.py`, `app/audience.py`, `app/exploitation.py`
`GET`	`/dashboard/argent`, `/dashboard/api`, `/dashboard/clients`, `/dashboard/site`, `/dashboard/registre`	pages du pilotage, une par section (D71), mêmes accès que `/dashboard`, période gardée par `?p=`	`app/routes/dashboard.py`, `app/pilotage_page.py`
`GET` `POST`	`/dashboard/mot-de-passe`, `/dashboard/nouveau-mot-de-passe`	comptes du tableau de bord (D74) : une adresse de `PILOTAGE_COMPTES` reçoit par mail un lien (30 min, une fois, empreinte seule en base) pour choisir son mot de passe (empreinte bcrypt) ; même réponse pour une adresse inconnue ; 3 liens par compte et par heure ; connexion ensuite par email	`app/pilotage_comptes.py`, `app/routes/dashboard.py`
`GET` `POST`	`/dashboard/connexion`, `/dashboard/deconnexion`	page de connexion du tableau de bord (D69), à la place de la fenêtre du défi Basic : cookie `__Host-av_pilotage` signé (HMAC, 12 h, HttpOnly, Secure, SameSite=Strict), mêmes 5 essais puis 15 min de pause, formulaire d'un autre site refusé ; un navigateur sans session y est renvoyé, un script garde le défi Basic	`app/routes/dashboard.py`, `app/pilotage_page.py`
`GET`	`/prospection`	CRM de prospection (liste, filtres, marquage, export) — privé, même garde que `/dashboard` (`503` si le mot de passe est absent ou si `PROSPECTION_DB` n'existe pas)	`app/routes/prospection.py`, `prospection/README.md`
`GET`	`/pricing`	page publique de l'offre commerciale (D43) — publique, indexable, cachée 5 min ; aucune ressource externe, feuille de style partagée avec `/dashboard` (`app/web.py`)	`app/routes/pricing.py`
`GET` `POST`	`/signup`	inscription self-service (D44) — publique ; mot de passe bcrypt, clé API `sk_live_` affichée une fois, 5 inscriptions par IP et par heure	`app/routes/signup.py`, `app/accounts.py`

| GET POST | /validate-form | essai gratuit public (D46) — publique, indexable, 3 essais par IP et par 24 h (D94) (429 + Retry-After exact au-delà) ; aucune écriture, ne charge rien, résultat dégradé annoncé comme tel ; accepte

只显示了开头部分；其余内容请在仓库中阅读

Address Validator

What it does

安装

打开 Claude 的 Connectors 页面

点击“Add” → “Custom” → “Web”，填写这 2 项

在聊天中开启

试一试

在网页版 ChatGPT 打开添加 MCP 的页面

填写名称和地址

在聊天中选择 Address Validator

试一试

打开终端

粘贴这条命令并按 Enter

在 Claude Code 中输入 /mcp

试一试

点击这个按钮打开 Cursor

在 Cursor 中以 Agent 模式打开 AI 聊天

试一试

点击这个按钮打开 VS Code

在 VS Code 中以 Agent 模式打开 AI 聊天

试一试

通过网页连接

一览

哪些应用可以使用它

它能做什么

基础检查i

作者与仓库一致

仍在维护

有许可证

端点有响应

使用 OAuth 登录

工具描述中没有隐藏指令

讨论

用户评价

与“其他”中的其他服务器比较i

常见问题

同类别的其他选择

World Monitor

Claude Flow

Windmill

作者的 README

Address Validator API

1. Présentation

2. Démarrage rapide

2. Configuration (jamais de secret dans le dépôt)

3. Lancer l'API

3. Configuration

4. Endpoints et contrat de données