用途：这是 sthan.io 提供的 MCP 服务器，把美国地址验证、地址解析、自动补全、经纬度地理编码、逆地理编码以及 IPv4/IPv6 定位能力接入 AI 助手，适用于 Claude Desktop、Claude Code、Cursor、VS Code、Windsurf 等 MCP 兼容客户端。共提供 8 个工具，采用 TypeScript，stdio 传输。
主要能力：地址验证基于官方邮政记录而非启发式规则，返回投递点验证（DPV）、ZIP+4、住宅/商业标记；自动补全对地址、城市和邮编提供低于 100 毫秒的输入提示级响应；正向地理编码返回精度分类（屋顶级/插值/质心/近似）与置信度分数；IP 定位返回国家、地区、城市、坐标、邮编、时区及当地时间、旗帜、货币、电话代码、网络（ASN、ISP、组织）、移动/代理/托管标记、反向 DNS 和置信度分数。
使用方式：先到 sthan.io 注册并从仪表盘获取免费 API 密钥（无需信用卡）。Claude Desktop 可下载 sthan.mcpb 双击安装并输入密钥；VS Code 有安装按钮；Cursor 安装后在设置中把占位符替换为密钥；Claude Code 可用命令：claude mcp add sthan -e STHAN_API_KEY=your_key_here -- npx -y @sthan/mcp-server，加 --scope user 可全局使用。也可手动编辑配置文件：Claude Desktop 编辑 claude_desktop_config.json，Cursor 编辑 ~/.cursor/mcp.json 或项目内 .cursor/mcp.json，Windsurf 编辑 ~/.codeium/windsurf/mcp_config.json，VS Code 创建 .vscode/mcp.json。安装后可自然提问，例如“123 Main St, New York, NY 10001 是可投递的真实地址吗”“解析地址 apt 2b 500 broadway new york ny”“1600 Pennsylvania Ave, Washington DC 的坐标是什么”“IP 8.8.8.8 在哪里”。
限制：多数调用 1 至 3 秒返回，但地址验证与解析在需要实时邮政查询时可能长达约 2 分钟，服务器对这两个工具最多等待 150 秒，客户端若提前超时需调高工具超时（如 Claude Code 设置 MCP_TOOL_TIMEOUT=150000）。使用 npx 时须保留 -y；Windows 上建议在 PowerShell 或命令提示符运行，若出现 spawn npx ENOENT 可改用 "command": "cmd" 与 "args": ["/c", "npx", "-y", "@sthan/mcp-server"]。定价、具体免费额度与更多环境变量细节暂未提供，可参考 sthan.io/pricing/united-states 与 sthan.io/docs。
