English Français العربية

io.github.qinisolabs/localecheck

السجل الرسمي المالية والمدفوعات

Verified locale data for AI agents: dates, phone, currency, tax, holidays, addresses (UK/US)

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package localecheck
Claude Code 
claude mcp add localecheck -- npx -y localecheck@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "localecheck": {
            "command": "npx",
            "args": [
                "-y",
                "localecheck@0.1.1"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. localecheck
  2. Packages
  3. What it does
  4. Quick start (in an AI app)
  5. Repo map
  6. Status & caveats

localecheck

Locale-correctness tools for AI agents. Agents are systematically wrong about everyday non-US data — they read 03/04 as March 4 in the UK, apply today's VAT rate to a historical invoice, format €1,234.50 for a German reader, and miss bank holidays in delivery dates. localecheck gives them verified answers and flags impossible inputs instead of guessing.

Coverage: UK + USA (v1), expanding. Free, no API key.

Packages

PackageInstallUse
TypeScript (primary)packages/localecheck-tsnpx -y localecheck (live on npm)MCP server and importable library
Pythonpackages/localecheck-pythonfrom source (PyPI release coming soon)MCP server, importable library, REST API

Both wrap the same authoritative libraries (libphonenumber, CLDR/Intl, date-holidays) and share the same hand-curated tax data.

What it does

parse_date · validate_phone · format_currency · tax_rate (VAT/sales-tax by date) · is_holiday / next_holiday · parse_address

Quick start (in an AI app)

{ "mcpServers": { "localecheck": { "command": "npx", "args": ["-y", "localecheck"] } } }

Then ask naturally — the agent picks the tool: "A UK invoice dated 1 June 2009 — what VAT rate?" → 15%.

Repo map

  • packages/localecheck-ts — primary TypeScript package (MCP + library)
  • packages/localecheck-python — Python package + FastAPI REST API
  • eval/ — benchmark harness: how often raw LLMs get this wrong
  • benchmark.html — shareable results page · BUSINESS_MODEL.md — strategy · PUBLISH.md — release steps · LOCAL_TEST.md — test before publishing

Status & caveats

UK VAT history is reliable for the modern era (standard rate). US state sales-tax values are 2025 state base rates (local taxes add on top) — verify against an authoritative feed before live invoicing. Addresses parse + extract a valid postcode/ZIP but don't verify deliverability.

Code: Apache-2.0. Curated tax data: see BUSINESS_MODEL.md.

الأسئلة الشائعة

ما هو io.github.qinisolabs/localecheck؟

Verified locale data for AI agents: dates, phone, currency, tax, holidays, addresses (UK/US)

كيف أثبّت io.github.qinisolabs/localecheck؟

يعمل على جهازك. في Claude Code: claude mcp add localecheck -- npx -y localecheck@0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.qinisolabs/localecheck إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.qinisolabs/localecheck مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص Apache-2.0.

من يصون io.github.qinisolabs/localecheck؟

ينشره qinisolabs. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.