موصّل حركة (MCP)

آخر تحديث: 2026-10-22

تقدر تضيف حركة لـ Claude أو ChatGPT أو أي مساعد يدعم MCP، والمساعد يفحص النص العربي في كودك ويصلّحه قبل ما ترندر. الموصّل مجاني، وما يحتاج حساب ولا تسجيل دخول.

العنوان

https://mcp.harakah.si/mcp

• Claude: من الإعدادات ← Connectors ← Add custom connector، الصق العنوان، واترك إعدادات OAuth فاضية.
• ChatGPT: ثبّت إضافة Harakah Arabic Motion، أو أضف العنوان كتطبيق مخصّص في وضع المطوّر.
• Claude Code: claude mcp add --transport http harakah https://mcp.harakah.si/mcp
• غيرها: أي عميل يدعم Streamable HTTP. ما يحتاج مفاتيح ولا ترويسات خاصة.

الأداتين

• check_arabic: تفحص ملف واحد (صفحة HTML أو GSAP أو HyperFrames، أو مكوّن Remotion) وترجّع كل مشكلة برقم السطر: حروف مفصولة بسبب التقسيم حرف حرف، اتجاه ناقص من اليمين لليسار، خطوط ما فيها عربي، تباعد حروف على نص عربي، أرقام مخلوطة، ارتفاع سطر يقصّ التشكيل، ونص مرسوم حرف حرف على canvas أو 3D.
• fix_arabic: ترجّع نسخة مصلّحة من نفس الملف. تحافظ على حركة الحروف وحدة وحدة والحروف تبقى متصلة، وتعلّم كل تغيير بتعليق harakah:.

الأداتين للقراءة فقط: ما تعدّل ملفاتك، ترجّع نص بس، والمساعد أو أنت تقرّرون وش تستخدمون منه. خيارات اختيارية: kind (html أو remotion، والافتراضي تحديد تلقائي)، وdigits (eastern أو western أو keep)، وsplit لـ fix_arabic (zwj أو word).

أمثلة تكتبها للمساعد

• «افحص مكوّن Remotion هذا من مشاكل العربي قبل ما أرندره» والصق المكوّن.
• «صلّح العربي في هيرو GSAP SplitText هذا عشان الحروف تبقى متصلة وتتحرك وحدة وحدة.»
• «خلّ كل الأرقام في بطاقة العنوان هذي أرقام عربية (١٢٣) واضبط الاتجاه من اليمين لليسار.»
• «ليش عنواني العربي يطلع مقطّع في مشهد three.js هذا؟»

الحدود

• ملف واحد في كل استدعاء، والكود لحد ٢٠٠٬٠٠٠ حرف.
• الأداة ما تفتح روابط ولا تقرأ مشروعك، تشوف بس الكود اللي يرسله المساعد. لمشروع كامل أو رندر فعلي، استخدم حركة على جهازك.
• لما يستخدم الكود المصلّح مكوّن Remotion المساعد، تحتاج الملف ./harakah-arabic من حزمة @harakah/remotion-arabic على npm، أو شغّل npx harakah-fixer fix --write محلياً.

إذا واجهتك مشكلة

• الموصّل ما يتصل: تأكد إن العنوان ينتهي بـ /mcp وإنه https، واترك حقول OAuth فاضية.
• الأدوات ما تظهر: شغّل الموصّل للمحادثة من قائمة الأدوات، أو افصله ووصّله من جديد.
• «code must be a non-empty string»: المساعد ما أرسل الكود. الصق الملف نفسه في المحادثة.
• التحديد التلقائي غلط: اطلب من المساعد يحدّد kind بنفسه (remotion أو html).
• خطأ 503 أو انقطاع: جرّب بعد شوي، أو استخدم الأداة على جهازك.

الخصوصية والدعم

الكود ينعالج في الذاكرة وما أخزّنه ولا أسجّله، والتفاصيل في سياسة الخصوصية. لأي سؤال راسلني على [email protected] أو افتح بلاغ على GitHub.

Harakah connector (MCP)

Last updated: 2026-10-22

Add Harakah to Claude, ChatGPT or any MCP client, and your assistant can check and fix the Arabic text in your code before you render. It's free, with no account and no sign-in.

Server URL

https://mcp.harakah.si/mcp

• Claude: Settings → Connectors → Add custom connector, paste the URL, and leave the OAuth fields empty.
• ChatGPT: install the Harakah Arabic Motion plugin, or add the URL as a custom app in developer mode.
• Claude Code: claude mcp add --transport http harakah https://mcp.harakah.si/mcp
• Others: any client that supports Streamable HTTP. No keys or special headers needed.

The two tools

• check_arabic: checks one file (an HTML, GSAP or HyperFrames page, or a Remotion component) and reports each problem with its line number: letters split apart by per-letter animation, missing right-to-left direction, Latin-only fonts, letter-spacing on Arabic, mixed digit styles, tight line-height that clips diacritics, and canvas or 3D text drawn letter by letter.
• fix_arabic: returns a repaired copy of the same file. It keeps your per-letter animation while the letters stay joined, and marks every change with a harakah: comment.

Both tools are read-only: they never change your files and only return text. Optional arguments: kind (html or remotion; auto-detected by default), digits (eastern, western or keep), and for fix_arabic, split (zwj or word).

Example prompts

• "Check this Remotion component for Arabic problems before I render it:" followed by the component.
• "Fix the Arabic in this GSAP SplitText hero so the letters stay connected but still animate one by one."
• "Make all the numbers in this HTML title card Eastern Arabic (١٢٣) and set it right-to-left."
• "Why does my Arabic title look disconnected in this three.js scene?"

Limits

• One file per call, up to 200,000 characters of code.
• The tool doesn't fetch URLs or read your project; it only sees the code the assistant sends. For a whole project or a real render, use Harakah on your computer.
• When fixed Remotion code uses the helper component, you need ./harakah-arabic from the @harakah/remotion-arabic npm package, or run npx harakah-fixer fix --write locally.

Troubleshooting

• The connector won't connect: check that the URL is https and ends in /mcp, and leave the OAuth fields empty.
• The tools don't appear: enable the connector for the chat from the tools menu, or disconnect and reconnect it.
• "code must be a non-empty string": the assistant didn't send the code. Paste the file itself into the chat.
• Wrong file type detected: ask the assistant to set kind (remotion or html).
• 503 errors or timeouts: try again shortly, or use the local tool.

Privacy and support

Code is processed in memory and never stored or logged; see the privacy policy. Questions: [email protected] or a GitHub issue.