关于 Localecheck
Localecheck 为处理英国和美国数据的 AI Agent 与开发者提供经核验的区域化工具,涵盖日期、电话、货币、税率、节假日和地址,并会标记无效输入而非猜测。
主要功能
- 01解析区域格式日期
- 02验证电话号码
- 03格式化货币
- 04按日期查询 VAT 和销售税
- 05查询公共假日
- 06解析英国和美国地址
适用场景
- 01查询发票对应的历史 VAT
- 02按地区格式化金额
- 03规划配送日期时检查节假日
- 04验证电话号码并解析地址
MCP 相关
TypeScript 和 Python 软件包提供 MCP 服务,开放区域解析、验证、格式化、税务、节假日和地址工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
7收录的工具列表 · 更新于 3 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| input | string | 是 | |
| locale | string | 否 |
详细介绍
localecheck
面向 AI Agent 的区域设置校验工具。 AI Agent 在日常非美国数据处理上常常出错——在英国把 03/04 读作 3 月 4 日,对历史发票套用今天的增值税税率,为德国读者格式化 €1,234.50,还会漏掉配送日期中的银行假日。localecheck 为它们提供经过验证的答案,并标记不可能的输入,而不是猜测。
覆盖范围:英国 + 美国(v1),并将继续扩展。免费,无需 API 密钥。
软件包
| 软件包 | 安装 | 用途 | |
|---|---|---|---|
| TypeScript(主要) | packages/localecheck-ts | npx -y localecheck(已在 npm 上线) | MCP 服务和可导入的库 |
| Python | packages/localecheck-python | 从源代码安装(即将发布到 PyPI) | MCP 服务、可导入的库、REST API |
两者都封装了相同的权威库(libphonenumber、CLDR/Intl、date-holidays),并共用同一套人工整理的税务数据。
功能
parse_date · validate_phone · format_currency · tax_rate(按日期查询增值税/销售税)· is_holiday / next_holiday · parse_address
快速开始(在 AI 应用中)
{ "mcpServers": { "localecheck": { "command": "npx", "args": ["-y", "localecheck"] } } }
然后自然地提问——Agent 会选择相应的工具:“一张日期为 2009 年 6 月 1 日的英国发票,适用什么增值税税率?” → 15%。
仓库目录
packages/localecheck-ts— 主要的 TypeScript 软件包(MCP + 库)packages/localecheck-python— Python 软件包 + FastAPI REST APIeval/— 基准测试框架:原始大模型出错的频率benchmark.html— 可分享的结果页面 ·BUSINESS_MODEL.md— 策略 ·PUBLISH.md— 发布步骤 ·LOCAL_TEST.md— 发布前测试
状态与注意事项
英国现代时期的增值税历史数据(标准税率)可靠。美国各州的销售税值为 2025 年的州基础税率(地方税费会在此基础上叠加)——在实际开票前,请对照权威数据源进行核验。地址解析会提取有效的邮政编码/ZIP,但不会验证是否可投递。
代码:Apache-2.0。整理后的税务数据:参见 BUSINESS_MODEL.md。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。