validalatam-mcp

validalatam-mcp

适用于 ValidaLatam API 的 MCP 服务——验证、规范化并格式化拉丁美洲的税号、国民身份证号和银行账户：AR CUIT/CUIL/DNI/CBU/CVU、BR CPF/CNPJ、MX RFC/CURP/CLABE、CL RUT、CO NIT、PE RUC、UY CI/RUT、EC Cédula/RUC、PY RUC、IBAN。

这是一个轻量级客户端：每次工具调用都会向托管的 API 发送 HTTP 请求。这里不包含任何验证算法。

RapidAPI API 密钥 / 套餐：https://rapidapi.com/MatiasPengue/api/validalatam

English | Español

English

安装

uvx --from git+https://github.com/elmatis172/validalatam-mcp validalatam-mcp
# or
pip install git+https://github.com/elmatis172/validalatam-mcp
validalatam-mcp

（发布到 PyPI 后：uvx validalatam-mcp / pip install validalatam-mcp。）

Claude Desktop（claude_desktop_config.json）/ Cursor（~/.cursor/mcp.json）

{
  "mcpServers": {
    "validalatam": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/elmatis172/validalatam-mcp", "validalatam-mcp"],
      "env": { "RAPIDAPI_KEY": "optional-your-key" }
    }
  }
}

工具

• validate_document(type, value, country?) — type="AUTO" 可自动检测
• validate_batch(items) — 最多 1000 个 {type, value, country?}
• generate_test_data(type, count, seed) — 生成明显为虚构且校验位有效的值
• list_document_types()

配置

环境变量	默认值	用途
RAPIDAPI_KEY	–	推荐设置。设置后，请求将通过 RapidAPI（validalatam.p.rapidapi.com）发送，并使用套餐配额（提供免费的 Basic 套餐）。如果未设置，公共端点每天会按 IP 地址提供少量免费验证次数（批量请求中的每份文档都会单独计数）。
VALIDALATAM_BASE_URL	https://validalatam.ia-latam.app	覆盖 API 基础 URL

Docker

docker build -t validalatam-mcp . && docker run -i --rm validalatam-mcp

客户端 SDK

零依赖客户端位于 sdks/python/validalatam_client.py 和 sdks/js/index.mjs。

开发

pip install -e ".[test]" && pytest

Español

适用于 ValidaLatam API 的 MCP 服务：验证、规范化并格式化 CUIT/CUIL、DNI、CBU/CVU、CPF、CNPJ、RFC、CURP、CLABE、RUT、NIT、RUC、CI、身份证件和 IBAN。这是一个轻量级客户端：每个工具都会通过 HTTP 调用托管的 API；不包含验证算法。

RapidAPI API 密钥和套餐：https://rapidapi.com/MatiasPengue/api/validalatam

安装

uvx --from git+https://github.com/elmatis172/validalatam-mcp validalatam-mcp
# o
pip install git+https://github.com/elmatis172/validalatam-mcp

Claude Desktop / Cursor

在 claude_desktop_config.json 或 ~/.cursor/mcp.json 中使用上文相同的 JSON 代码块。RAPIDAPI_KEY 是可选项，但建议设置：不设置密钥时，公共端点每天会按 IP 地址提供少量免费验证次数（批量请求中的每份文档都会单独计数）。设置密钥后会使用 RapidAPI 套餐的配额（提供免费的 Basic 套餐）。

工具

validate_document、validate_batch、generate_test_data（虚假的测试数据）、list_document_types。

许可 / 许可

MIT