Arabic Writing Assistant
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Arabic Writing Assistant
مساعد للكتابة العربية يعمل عبر MCP، يقدّم إرشادًا لغويًا موثقًا ويفحص الترقيم، والتنصيص، والتنسيق. يستطيع المستخدم ربطه بعميل ذكاء اصطناعي يدعم MCP.
A source-aware Arabic writing assistant over MCP. It provides language guidance, punctuation checks, quotation and formatting help, and selective diacritics for a small curated set of ambiguous words.
بالعربية
ماذا يقدم؟
البحث عن قواعد عربية مع أمثلة وروابط للمصادر.
فحص آلي محدود للمسافات وعلامات الترقيم والأقواس والتنصيص.
عرض معاني بعض الكلمات الملتبسة، مع التشكيل على الحروف التي تميّز المعنى فقط.
إعداد قائمة مراجعة تساعد النموذج المضيف على تدقيق النص. الحكم النحوي والدلالي النهائي يعتمد على النموذج والسياق، وليس على فحص آلي كامل.
توجيه تنسيق الفقرات العربية RTL، وعزل الروابط والأكواد والمقاطع اللاتينية باتجاه LTR عند إنشاء HTML أو مستند منسق.
بنك القواعد والكلمات الملتبسة بداية قابلة للتوسعة، وليس مرجعًا شاملًا لكل مدارس النحو أو أدلة الأسلوب. مدخلات الالتباس الحالية تشمل خمس كلمات غير مضبوطة بالشكل: ملك، علم، فهم، سلم، كتب. نضيف المداخل مع مصادر مباشرة ومراجعة مناسبة.
تشغيل سريع
يتطلب Python 3.11 أو أحدث وuv.
git clone https://github.com/ENG-BBB/arabic-writing-assistant.git
cd arabic-writing-assistant
uv sync
uv run mcp dev server.pyللتشغيل مع عميل محلي يستخدم stdio:
uv run mcp run server.pyولتشغيل واجهة HTTP محليًا:
uv run python server.pyيوجد شرح ربط Claude وChatGPT والعملاء الأخرى في Integration Guide.
هل يحتاج المستخدم إلى تعديل الكود؟
لا. يمكن تشغيل الأداة كما هي؛ يحتاج المستخدم فقط إلى تثبيت المتطلبات وإعداد اتصال MCP مرة واحدة في التطبيق. تختلف طريقة الاتصال باختلاف العميل:
Claude Code وQwen Code وKimi Code: يمكن تشغيل الخادم محليًا عبر stdio؛ لا تحتاج هذه الطريقة إلى استضافة عامة.
ChatGPT على الويب: مستودع GitHub وحده لا يربط الأداة بـChatGPT. يلزم عنوان MCP عبر HTTPS ينتهي بـ
/mcpأو نفق آمن مدعوم، ويعتمد توفر الاتصال المخصص على الخطة وإعدادات مساحة العمل.DeepSeek: يلزم استخدامه عبر تطبيق أو مضيف يدعم MCP؛ دعم النموذج أو API لاستدعاء الأدوات لا يعني أن موقع المحادثة نفسه يقبل خادم MCP.
راجع Integration Guide لأوامر الإعداد الخاصة بكل عميل.
أمثلة لطلبات
«ابحث عن قاعدة كتابة الهمزة المتوسطة مع مثال.»
«افحص علامات الترقيم والمسافات في هذا النص.»
«ما المعاني المحتملة لكلمة ملك في هذه الجملة؟»
«راجع النص، وميّز التصحيح اللغوي المؤكد من الاقتراح الأسلوبي.»
Related MCP server: MCP Arabic Toolkit
English
What it does
Searches a curated bank of Arabic grammar, spelling, punctuation, quotation, and formatting guidance.
Checks mechanical punctuation patterns, spacing, and paired delimiters.
Looks up documented meanings for selected ambiguous unvowelled words and marks only letters that distinguish candidate meanings.
Prepares a sourced proofreading checklist for the connected host model.
Provides guidance for right-to-left Arabic blocks and isolated left-to-right snippets in mixed-script HTML.
This is an actively maintained starting set, not a complete grammar authority. The current ambiguous-word bank covers five spellings: ملك, علم, فهم, سلم, and كتب. The host model makes context-sensitive language judgments; the server does not perform a complete automatic grammar analysis.
Quick start
Requires Python 3.11+ and uv.
git clone https://github.com/ENG-BBB/arabic-writing-assistant.git
cd arabic-writing-assistant
uv sync
uv run mcp dev server.pySee the Integration Guide for client-specific setup instructions.
Do users need to modify the source code?
No. Users can run the project as-is; they only need to install its dependencies and configure the MCP connection once in their client. The connection method depends on the client:
Claude Code, Qwen Code, and Kimi Code: can launch the server locally over stdio; this does not require public hosting.
ChatGPT web: the GitHub repository alone does not connect the tool to ChatGPT. It needs a reachable HTTPS MCP endpoint ending in
/mcpor a supported secure tunnel. Availability depends on the account plan and workspace settings.DeepSeek: use it through an MCP-capable host or adapter; model/API tool calling alone does not make the standard chat website an MCP client.
See the Integration Guide for client-specific setup commands.
Available tools
search_arabic_rules: search sourced guidance by topic or category.audit_arabic_punctuation: flag mechanical punctuation, spacing, repeated marks, and unmatched delimiters.disambiguate_arabic_word: return documented candidate meanings and selective diacritics.review_arabic_text: prepare a review checklist and relevant source rules for the host model.
The punctuation audit does not determine whether punctuation matches the intended meaning. The review tool returns guidance for the host model; it does not independently guarantee a correct proofread.
Sources
Rule entries return source names and URLs. The bank draws on these references:
King Salman Global Academy for Arabic Language: spelling in the Arabic writing system
King Salman Global Academy for Arabic Language: Arabic grammar curricula
Egyptian Ministry of Awqaf: punctuation overview and examples
Text direction and mixed scripts
For structured HTML documents, set the base direction on Arabic blocks, for example <p lang="ar" dir="rtl">…</p>. Direction is separate from right alignment. Keep code, URLs, email addresses, and Latin identifiers left-to-right and isolate them from surrounding Arabic, for example <bdi dir="ltr">https://example.com</bdi>; use <bdi dir="auto"> for unknown-direction inline content. Do not reverse characters manually. Avoid directional override controls such as RLO/LRO unless a specific, reviewed use requires them.
This MCP server returns text and formatting guidance; the host application controls how plain-text results are displayed. The punctuation audit does not verify visual RTL layout.
Data handling and security
The application code has no database or file-writing logic and does not call an external model or language API. It processes text supplied for a tool call and returns language guidance. The connected AI client also receives the text under that service's own data policies.
The HTTP server currently has no authentication or rate limiting. Keep it on localhost or use a private tunnel unless you add appropriate access controls before exposing a hosted endpoint. Hosting providers may keep operational logs according to their own settings and policies; review those settings before deployment. Do not send confidential text to a hosted instance until you have reviewed its data handling.
Scope
The initial profile is Modern Standard Arabic. Dialects, academic citation systems, publisher-specific styles, and Qur'anic orthography need separate profiles. When a source is silent or a choice depends on house style, the tool should say so rather than present one preference as a universal rule.
Contributing
Rule contributions should include a short statement, at least one example, a directly relevant source, and a confidence label (standard, common, or style-dependent). For ambiguous-word entries, cite a dictionary or grammar source for every candidate meaning and verify that selective rendering marks only the letters that distinguish the candidate forms.
License
This project is licensed under the MIT License.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Grounded MENA legal search, reasoning, citation resolution, and citation-graph traversal.
Amounts in words (Arabic cheque grammar), number formatting, Arabic text tools, date parsing.
English And Arabic Public Guidance On Human Judgement, With Versioned Sources And Review Limits.
Free mechanical checks for AI text: unnamed counts, dangling references, bad arithmetic, misquotes.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceProvides Arabic UI/UX design tools as an MCP server, offering RTL conversion, Arabic typography validation, cultural palettes, and anti-AI-slop auditing for AI-assisted design workflows.MIT
- AlicenseBqualityCmaintenanceEnables AI agents to normalize Arabic text, strip diacritics, classify regional dialects, and analyze prompt token efficiency. Exposes these capabilities as MCP tools that plug into Claude Desktop, Cursor, and other MCP clients.4MIT
- AlicenseBqualityCmaintenanceEnables dependable Arabic text normalization and search preparation for RAG and deduplication, with typed outputs, stable fingerprints, and experimental dialect, sentiment, and diacritization tools.2MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI hosts to check text for grammar, spelling, and style errors, measure readability, and generate tone-adjusted rewrites through structured tool calls. Every tool returns predictable, typed output for reliable routing and results.MIT