Sthan MCP服务器
MCP服务器 斯坦尼奥 --让你的人工智能助手能够验证、解析、自动完成和地理编码美国地址，并查找IP地理位置。适用于Claude Desktop、Claude Code、Cursor、VS Code、Windsurf和任何兼容MCP的客户端。
8个工具·TypeScript·stdio传输·免费层，无需信用卡。
______________________________________________________________________
为什么要用它
- 真实美国邮政数据 --地址是根据权威的邮政记录进行验证的，而不是启发式方法。退货交付点验证（DPV），邮政编码+4，住宅/商业标志。
- Sub-100ms自动补全 --提前输入地址、城市和邮政编码建议的等级响应时间。
- 强大的地理编码 --正向地理编码返回精度分类（屋顶/插值/质心/近似）加上置信度得分，因此您的AI知道何时信任结果。
- IPv4+IPv6地理定位 --国家、地区、城市、坐标、时区、邮政编码。
- 无信用卡免费套餐 --在一分钟内拿到钥匙 sthan.io/仪表板.
工具
| 工具 | 它做什么 |
|---|---|
sthan_verify_address | 验证美国地址是否真实且可交付。返回标准格式，ZIP+4，DPV，住宅/商业。 |
sthan_parse_address | 将自由格式的美国地址文本解析为结构化组件（街道号、名称、类型、方向、单位、城市、州、邮政编码）。 |
sthan_autocomplete_address | 从部分输入中建议完整的美国地址。低于1000毫秒。 |
sthan_autocomplete_city | 根据部分输入建议美国城市，并注明州代码。 |
sthan_autocomplete_zipcode | 根据部分输入建议美国邮政编码。 |
sthan_geocode | 美国地址→ 准确度+置信度的纬度/经度。 |
sthan_reverse_geocode | 纬度/经度→ 最近的美国街道地址，距离单位为米。 |
sthan_ip_geolocation | IPv4或IPv6→ 国家、地区、城市、坐标、时区、邮政编码。 |
快速启动
1.获得免费的API密钥
2.添加到您的MCP客户端
克劳德桌面/克劳德代码 (~/.claude/mcp.json 或项目 .claude/mcp.json):
{
"mcpServers": {
"sthan": {
"command": "npx",
"args": ["-y", "@sthan/mcp-server"],
"env": { "STHAN_API_KEY": "sthan_test_your_key_here" }
}
}
}光标 (.cursor/mcp.json):
{
"mcpServers": {
"sthan": {
"command": "npx",
"args": ["-y", "@sthan/mcp-server"],
"env": { "STHAN_API_KEY": "sthan_test_your_key_here" }
}
}
}VS Code (settings.json):
{
"mcp.servers": {
"sthan": {
"command": "npx",
"args": ["-y", "@sthan/mcp-server"],
"env": { "STHAN_API_KEY": "sthan_test_your_key_here" }
}
}
}示例提示
配置后，只需自然地询问您的AI助手：
- *“纽约市主街123号，邮编10001，是一个真实的可交付地址吗？”*
- *解析此地址：纽约百老汇500号公寓2b室*
- *“华盛顿特区宾夕法尼亚大道1600号的坐标是多少？”*
- *“离40.7128，-74.0060最近的地址是什么？”*
- *“IP 8.8.8.8位于何处？”*
- *“建议以‘San Fr’开头的美国城市。”*
环境变量
| 变量 | 必填 | 描述 |
|---|---|---|
STHAN_API_KEY | 是 | 您的sthan.io API密钥(sthan_test_* 为了发展， sthan_live_* 用于生产） |
STHAN_API_URL | 否 | 覆盖基本URL（默认值： https://api.sthan.io) |
包裹
这个monorepo发布了两个包：
| 包 | npm | 目的 |
|---|---|---|
@sthan/mcp-server | ](https://www.npmjs.com/package/@sthan/mcp-server) | MCP服务器本身——客户端启动的二进制文件 |
@sthan/core | ](https://www.npmjs.com/package/@sthan/core) | TypeScript SDK，用于直接编程使用sthan.io API |
发展
git clone https://github.com/sthan-io/mcp-server.git
cd mcp-server
npm install
npm run build --workspaces然后使用以下命令运行服务器 STHAN_API_KEY=sthan_test_... node packages/mcp-server/dist/index.js.
链接
- 主页： https://sthan.io
- API文件： https://sthan.io/docs
- OpenAPI规范： https://api.sthan.io/openapi.json
- AI参考(
llms-full.txt): https://api.sthan.io/llms-full.txt - 定价： https://sthan.io/pricing/united-states
- 技术支持： https://sthan.io/support
- 格拉玛： https://glama.ai/mcp/servers/sthan-io/mcp-server
许可证
麻省理工学院——见 许可证.