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.

Related MCP server: flexorch-mcp

🛠️ MCP Tools Exposed

🚀 Quickstart & Installation

Option A: Direct Run via uvx (No installation needed)

uvx mcp-arabic-toolkit

Or configure Claude Desktop / Cursor directly:

{
  "mcpServers": {
    "arabic-toolkit": {
      "command": "uvx",
      "args": ["mcp-arabic-toolkit"]
    }
  }
}

Option B: Local Clone & Development

git clone https://github.com/seotarek/mcp-arabic-toolkit.git
cd mcp-arabic-toolkit
pip install -e .

🧪 Testing

Run the automated test suite:

python -m unittest discover tests

📜 License

This project is open source and available under the MIT License.