LightGuard-Agent 🛡️

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: mhlabs-mcp-tools

🛠️ MCP Tools Exposed

🚀 Quickstart & Installation

1. Clone & Run

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

2. Configure with Claude Desktop or Cursor

Add the server configuration to your claude_desktop_config.json:

{
  "mcpServers": {
    "arabic-toolkit": {
      "command": "python",
      "args": ["-m", "mcp_arabic.server"],
      "cwd": "/path/to/mcp-arabic-toolkit"
    }
  }
}

🧪 Testing

Run the automated test suite:

python -m unittest discover tests

📜 License

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