Install
npx -y @mmntm/weblate-mcpلمن يناسب
هذا الدليل لمن يملك أصلًا مثيل Weblate بواجهة API يمكن الوصول إليها ويريد عرض المشاريع والبحث عن وحدات الترجمة في المحادثة. المسار الرسمي الرئيسي هو تشغيل @mmntm/weblate-mcp بـ npx وضبط WEBLATE_API_URL وWEBLATE_API_TOKEN. بلا عنوان مثيل ورمز لا تستدعِ شيئًا.
يناسب من يعرض المشاريع أولًا ثم يجد الترجمات بصيغة تصفية Weblate الأصلية. الأداتان اللتان تسمّيهما هذه الصفحة بالكامل هما listProjects وsearchUnitsWithFilters. لا يناسب فهم أدوات كتابة غير مذكورة كإذن لتغيير الترجمات؛ لا تخترع أسماء أدوات غير مكتوبة.
أول محاولة في 3 دقائق
أمر التثبيت الرسمي أدناه. المتطلبات: إمكانية تشغيل npx هنا (ملاحظات التطوير تذكر أيضًا Node.js 18+ وpnpm)، ومثيل Weblate instance مع API access. موضع الإعداد هو بند MCP في العميل: command هو npx وargs هما -y و@mmntm/weblate-mcp وenv يحمل WEBLATE_API_URL وWEBLATE_API_TOKEN. يجب أن يكون URL جذر API لـ Weblate الخاص بك؛ لا تستخدم أسماء مضيف المثال من الوثائق.
npx -y @mmntm/weblate-mcp
الصفحة الرسمية:
https://github.com/mmntm/weblate-mcp
لأول محاولة استخدم الأداة الرسمية listProjects: اعرض كل مشاريع Weblate المتاحة مع URL وmetadata. النجاح عودة مشاريع لا رفض الرمز. listProjects يصل إلى مثيل Weblate الذي ضبطته؛ لا تفهم ذلك بأنه بلا شبكة أو بلا حد خصوصية.
حالات الاستخدام
الحالة الأولى: معرفة المشاريع على المثيل. تقابل listProjects. النص الرسمي يقول URLs and metadata ولا يكتب معاملات ترقيم أو تصفية؛ استخدم فقط ما يعرضه العميل. عند النجاح تظهر أسماء المشاريع.
الحالة الثانية: إيجاد وحدات ترجمة حسب التصفية. تقابل searchUnitsWithFilters. الوثائق الرسمية تقول إنها تستخدم Weblate's native filtering syntax وتصفها بطريقة فعالة لإيجاد translations. هذه الصفحة لا تعطي تعبير تصفية قابلًا للنسخ؛ لا تخترع صياغة. النجاح عودة وحدات مطابقة.
حدود الاستخدام
وسائل النقل المذكورة هنا تشمل HTTP/SSE وStreamable HTTP وSTDIO؛ لا منفذ افتراضي مكتوب فلا تخترعه. الرموز وعناوين المثيل توضع فقط في env المحلي. هذه الصفحة لا تعطي حدود معدل ولا جدول أدوات كتابة ولا خطوات للتراجع عن ترجمة. جانب التطوير يذكر أيضًا pnpm؛ ليست مثبّتًا رئيسيًا بديلًا لمسار npx، فلا تجعلهما خيارين أولين متساويين.
قبل استدعاء searchUnitsWithFilters أكّد أن التصفية من صياغة Weblate الأصلية لا من كلمة مرتجلة. listProjects يجيب فقط عن مشاريع المثيل ولا يغيّر أي ترجمة من تلقاء نفسه.