validalatam-mcp

validalatam-mcp

ValidaLatam API 用の MCP サーバーです。ラテンアメリカの納税者番号、国民 ID、銀行口座番号を検証、正規化、フォーマットします。対象は 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

英語 | スペイン語

英語

インストール

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 ごとに 1 日あたり少数の検証を無料で利用できます（バッチでは文書ごとにカウントされます）。
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

スペイン語

ValidaLatam API 用の MCP サーバーです。CUIT/CUIL、DNI、CBU/CVU、CPF、CNPJ、RFC、CURP、CLABE、RUT、NIT、RUC、CI、身分証明書、IBAN を検証、正規化、フォーマットします。軽量なクライアントで、各ツールはホストされた API を HTTP 経由で呼び出します。検証アルゴリズムは含まれていません。

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

上記と同じ JSON ブロックを claude_desktop_config.json または ~/.cursor/mcp.json で使用してください。RAPIDAPI_KEY は任意ですが、設定を推奨します。キーがない場合、パブリックエンドポイントでは IP ごとに 1 日あたり数件の検証を無料で利用できます（バッチでは文書ごとにカウントされます）。キーがある場合は、RapidAPI のプラン利用枠が使用されます（無料の Basic プランを利用できます）。

ツール

validate_document、validate_batch、generate_test_data（テスト用の偽データ）、list_document_types。

ライセンス

MIT