arabicfmt-mcp

arabicfmt-mcp

A Model Context Protocol (MCP) server that exposes arabicfmt — Arabic-first formatting for numbers, currency, Hijri dates, bidirectional text, and validation — as callable tools for AI agents such as Claude Desktop, Claude Code, and Cursor.

Once connected, an agent can format Saudi Riyal amounts, convert Gregorian dates to Hijri, spell numbers in Arabic, isolate foreign text for correct RTL rendering, validate IBANs and Saudi IDs, and more — by calling tools directly instead of guessing.

Run

No install or build step required — it runs straight from npm over stdio:

npx arabicfmt-mcp

The server speaks MCP over stdio. It is meant to be launched by an MCP client (see below), not run interactively.

Requires Node.js >= 18.

Configure your client

Add the server to your client's mcpServers configuration.

Claude Desktop

Edit your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Cursor

Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project):

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

Restart the client after editing, then ask the agent to use an arabicfmt tool.

Tools

Tool	Description
format_currency	Format a number as an Arabic currency amount with the correct symbol and precision (e.g. 1234.5 SAR -> ١٬٢٣٤٫٥٠ ر.س).
spell_currency	Spell a currency amount in full Arabic words with correct grammatical agreement.
format_hijri	Format a Gregorian date as a Hijri date string (e.g. ٢٣ رمضان ١٤٤٧ هـ).
to_hijri	Convert a Gregorian date to Hijri components {year, month, day}.
arabic_to_words	Convert an integer to Arabic cardinal words.
arabic_ordinal	Convert an integer to Arabic ordinal words (e.g. 25 -> الخامس والعشرون).
format_number	Format a number with grouping and optional Eastern Arabic numerals.
format_compact	Compact notation with Arabic scale words (e.g. 1.2 مليون).
parse_number	Parse a Latin/Eastern-Arabic numeric string into a number.
format_duration	Format milliseconds as natural Arabic words (e.g. ساعتان وخمس دقائق).
format_relative_time	Format a date relative to a base date (e.g. منذ ٣ أيام).
arabic_plural	Select the correct Arabic plural form for a count (CLDR categories).
isolate_foreign	Wrap foreign/LTR runs in bidi isolates for correct RTL rendering.
transliterate	Transliterate Arabic text to Latin script.
slugify	Convert Arabic/mixed text into a URL-safe slug.
validate_iban	Validate an IBAN via checksum and country length.
validate_saudi_id	Validate a Saudi national/iqama ID via its checksum.

Each tool returns its result as MCP text content. Date inputs are ISO 8601 strings (e.g. "2025-09-23"). The numerals option accepts "latn", "arab", or "arabext".

Development

cd mcp
npm install

Tool handlers are defined in tools.js and exported (tools, toolNames) so they can be unit-tested directly without a running server. index.js wires them into an McpServer (@modelcontextprotocol/sdk) over StdioServerTransport.

License

MIT (c) cc1a2b