Arabic is one of the most widely spoken languages in the world, yet AI agents and LLMs frequently struggle with Arabic diacritics (Tashkeel), character normalization (Alef/Yaa/Haa), and diverse regional dialects.

mcp-arabic-toolkit connects AI coding assistants and autonomous agents (Claude, Cursor, Antigravity) to a suite of specialized Arabic NLP tools via the standard Model Context Protocol (MCP).

GitHub logo seotarek / mcp-arabic-toolkit

A high-performance Model Context Protocol (MCP) server providing Arabic NLP, text normalization, diacritization, and dialect classification for AI agents.

MCP Arabic Toolkit 🌍

License: MIT CI Python 3.9+ MCP Protocol

A high-performance Model Context Protocol (MCP) server providing Arabic Natural Language Processing (NLP), text normalization, diacritics stripping, dialect detection, and token efficiency analysis for AI agents.

Developed by Tarek Mohamed (@seotarek)

✨ Features

  • ⚡ Model Context Protocol (MCP) Compatible: Plug directly into Claude Desktop, Cursor, and any MCP client.
  • 🧹 Advanced Arabic Normalization: Unify complex Alef variants, Hamza, Yaa, Taa Marbuta, and strip Tatweel.
  • 🎯 Tashkeel Stripping: Remove diacritics (Harakat) accurately with zero distortion to core roots.
  • 🗣️ Arabic Dialect Classification: Heuristic and marker-based identification across Egyptian (EGY), Levantine (LEV), Gulf (GLF), Maghrebi (MAG), and Modern Standard Arabic (MSA).
  • 📊 Token & Prompt Efficiency Metrics: Calculate character-to-word and token compression statistics to optimize LLM prompt budgets for Arabic workloads.

🛠️ MCP Tools Exposed

Tool Name Description
arabic_normalize_text Normalizes Arabic letters, unifies orthographic variants, and strips elongation.
arabic_strip_diacritics Strips all
…
View on GitHub

🌟 Available MCP Tools

  • normalize_arabic_text: Handles Alef normalization, Tatweel removal, and unicode hamza normalization.
  • strip_tashkeel: Ultra-fast diacritic stripper with 100% preserve of base consonants.
  • classify_dialect: Detects whether text is Modern Standard Arabic (MSA), Egyptian, Levantine, Gulf, or Maghrebi.
  • sentiment_analyzer: Domain-tuned sentiment scoring for Arabic social and customer reviews.

🔌 Connecting to Claude or Cursor

Add this to your mcpServers configuration:

{ "mcpServers": { "arabic-toolkit": { "command": "python", "args": ["-m", "mcp_arabic_toolkit.server"] } } }

Learn more and contribute on GitHub:
👉 https://github.com/seotarek/mcp-arabic-toolkit