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).
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 🌍
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 |
🌟 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
Top comments (0)