تفاصيل مشروع WordPress MCP

نظرة عامة على المشروع

WordPress MCP (بروتوكول سياق النموذج) هو إضافة WordPress تم تطويرها بواسطة Automattic، تهدف إلى تحويل موقع WordPress إلى خادم MCP بسيط، من خلال تعريض وظائف الموقع عبر WordPress REST API، مما يتيح للنماذج اللغوية الكبيرة (LLMs) ووكلاء الذكاء الاصطناعي التفاعل معه. يسمح هذا المشروع للمطورين بالاستفادة من أدوات الذكاء الاصطناعي لأتمتة مهام إدارة المحتوى، وعمليات المستخدم، وتكوين الموقع، مما يعزز كفاءة التطوير وقدرات التكامل.

الوظائف الأساسية

1. دعم خادم MCP:

   • توفير وظائف خادم MCP من خلال مسارات REST API (مثل /wp/v2/wpmcp و /wp/v2/wpmcp/streamable)، لدعم تفاعل وكلاء الذكاء الاصطناعي مع WordPress.
   • دعم طبقتين للنقل: McpStdioTransport (الإدخال والإخراج القياسي) و McpStreamableTransport (النقل المتدفق، مناسب لـ SSE أو بروتوكولات التدفق الأخرى).

2. آلية المصادقة:

   • اعتماد نظام مصادقة JWT (JSON Web Token) لضمان الاتصال الآمن.
   • دعم كلمات مرور تطبيقات WordPress (Application Passwords) ومفاتيح المستهلك السرية لـ WooCommerce REST API، لتعزيز الأمان.

3. معالجات الطرق:

   • توفير معالجات طرق مثل الأدوات (Tools) والموارد (Resources) والمطالبات (Prompts)، لدعم إدارة المحتوى وتهيئة الموقع وعمليات أخرى.
   • إمكانية توسيع الوظائف من خلال أدوات مخصصة لتلبية احتياجات محددة.

4. واجهة الإدارة:

   • توفير واجهة إدارة تعتمد على React، لتسهيل إدارة الرموز المميزة (Tokens) وتكوينات أخرى في لوحة تحكم WordPress.

5. التوافق مع عملاء MCP:

   • التعاون بسلاسة مع العملاء المتوافقين مع MCP (مثل Claude Desktop)، ودعم طلبات REST API من خلال وكيل (مثل mcp-wordpress-remote) دون الحاجة إلى اتصال مفتوح دائم.

مميزات المشروع

• الأمان: ضمان أمان البيانات من خلال مصادقة JWT وكلمات مرور التطبيقات، ويوصى باستخدام HTTPS لتشفير الاتصالات.
• القابلية للتوسع: دعم المطورين لتوسيع وظائف الإضافة من خلال إضافة أدوات وموارد ومطالبات مخصصة.
• سهولة التطوير: توفير وثائق اختبار مفصلة (tests/README.md) وإرشادات المساهمة، لتشجيع مشاركة المجتمع في التطوير.
• خفيف الوزن وفعال: تجنب وضع الوكيل الاتصالات المفتوحة الدائمة، وتحسين الأداء، ومناسب للتطوير المحلي والنشر عن بعد.
• ترخيص مفتوح المصدر: اعتماد ترخيص GPL v2 أو أعلى، مفتوح لمجتمعات WordPress والذكاء الاصطناعي.

الهيكل التقني

يشمل الهيكل الأساسي للمشروع الوحدات التالية:

• طبقة النقل (Transport Layer):

  • McpStdioTransport: معالجة طلبات MCP من خلال الإدخال والإخراج القياسي، مناسبة للتطوير المحلي.
  • McpStreamableTransport: دعم النقل المتدفق، مناسب لسيناريوهات التفاعل في الوقت الفعلي (قد لا تدعم بعض العملاء حاليًا).

• نظام المصادقة (Authentication):

  • استخدام مصادقة JWT، يجب تحديد WPMCP_JWT_SECRET_KEY في wp-config.php.
  • دعم كلمات مرور تطبيقات WordPress ومفاتيح WooCommerce، لتعزيز المرونة.

• معالجات الطرق (Method Handlers):

  • الأدوات (Tools): تنفيذ عمليات إنشاء المحتوى وتحديثه وحذفه.
  • الموارد (Resources): توفير واجهات للوصول إلى بيانات الموقع.
  • المطالبات (Prompts): توفير توجيه سياقي لوكلاء الذكاء الاصطناعي.
  • تهيئة النظام (System & Initialization): معالجة بدء تشغيل وتكوين خادم MCP.

• واجهة الإدارة (Admin Interface):

  • استخدام React للبناء، تقع في صفحة "الإعدادات > WordPress MCP" في لوحة تحكم WordPress، لإدارة الرموز المميزة والمفاتيح الوظيفية.

التثبيت والتكوين

خطوات التثبيت

1. استنساخ المستودع:

   cd wp-content/plugins/
   git clone https://github.com/Automattic/wordpress-mcp.git
   cd wordpress-mcp
   

2. تثبيت التبعيات:

   composer install --no-dev
   npm install && npm run build
   

3. تفعيل الإضافة:

   • تفعيل إضافة WordPress MCP في صفحة "الإضافات" في لوحة تحكم WordPress.

4. تكوين وظائف MCP:

   • انتقل إلى "الإعدادات > WordPress MCP"، وقم بتمكين وظائف MCP وتكوين الرموز المميزة للمصادقة.

5. تكوين مفتاح JWT: أضف في wp-config.php:

   define('WPMCP_JWT_SECRET_KEY', 'your-secret-key');
   define('WPMCP_DEBUG', true); // Enable debug logging
   

6. تثبيت العميل البعيد (اختياري):

   • للاستخدام مع mcp-wordpress-remote، استخدم الأمر التالي:

     npx @modelcontextprotocol/inspector \
     -e WP_API_URL=https://your-site.com/ \
     -e JWT_TOKEN=your-jwt-token-here \
     npx @automattic/mcp-wordpress-remote@latest
     

ملاحظات التكوين

• الأمان: لا تقم أبدًا بإرسال رموز المصادقة إلى نظام التحكم في الإصدار، وتأكد من تخزين WPMCP_JWT_SECRET_KEY بشكل آمن.
• التصحيح: يمكن لتمكين WPMCP_DEBUG تسجيل سجلات التصحيح لتسهيل استكشاف المشكلات وإصلاحها.
• عمليات الحذف: قد يؤدي حذف الأدوات إلى فقدان البيانات بشكل دائم، قم بتمكينها فقط للمستخدمين الموثوق بهم.
• الاعتماد على العميل البعيد: يجب استخدام إضافة WordPress MCP مع mcp-wordpress-remote لتحقيق الوظائف الكاملة.

حالات الاستخدام

مشروع WordPress MCP مناسب للحالات التالية:

1. أتمتة إدارة المحتوى:

   • إنشاء أو تحديث أو حذف المقالات والصفحات والمستخدمين وما إلى ذلك من خلال وكلاء الذكاء الاصطناعي، مما يوفر وقت التشغيل اليدوي.
   • مثال: استخدم أمر Claude Desktop "إنشاء 10 مقالات مسودة بعنوان 'مقالة اختبار #1-10'" لإنشاء محتوى اختبار تلقائيًا.

2. التطوير والاختبار:

   • يمكن للمطورين استخدام أدوات MCP لإنشاء بيانات اختبار بسرعة، وتسريع اختبار الوظائف وتطوير التكامل.
   • مثال: من خلال وكيل الذكاء الاصطناعي، استعلم عن سجلات التصحيح ولخص المشكلات، مما يبسط عملية التصحيح.

3. إدارة الموقع:

   • إدارة تكوين الموقع أو أذونات المستخدم أو ملفات الوسائط عن بُعد، ومناسبة لتعاون الفريق الموزع.
   • دعم تكامل WooCommerce، يمكن إدارة البيانات المتعلقة بالتجارة الإلكترونية (مثل الطلبات والمنتجات).

4. التخصيص المدفوع بالذكاء الاصطناعي:

   • يمكن للمطورين إضافة أدوات مخصصة، وتعريض منطق الأعمال المحدد، لتلبية الاحتياجات الفردية.
   • مثال: إنشاء أداة مخصصة لتحديث فئات المقالات أو تحسين بيانات التعريف الخاصة بتحسين محركات البحث (SEO) بشكل مجمّع.

التوسيع والتطوير

إضافة أدوات مخصصة

يمكن للمطورين توسيع وظائف الإضافة من خلال الخطوات التالية:

1. إنشاء ملف أداة:

   • أضف فئة أداة جديدة في الدليل wp-content/plugins/wordpress-mcp/includes/Tools/.
   • مثال لفئة أداة:

     <?php
     namespace WPMCP\Tools;
     class CustomTool {
         public function execute($params) {
             // تنفيذ منطق مخصص
             return ['success' => true, 'data' => 'Custom tool executed'];
         }
     }
     

2. تسجيل الأداة:

   • سجل الأداة الجديدة عند تهيئة الإضافة، وتأكد من أنها متاحة من خلال واجهة MCP.

3. الرجوع إلى التنفيذات الحالية:

   • عرض أمثلة التعليمات البرمجية في الأدلة includes/Tools/ و includes/Resources/ و includes/Prompts/.

المساهمة في التعليمات البرمجية

• إرشادات المساهمة: راجع إرشادات المساهمة في المستودع، وأرسل طلبات السحب أو أبلغ عن المشكلات.
• وثائق الاختبار: راجع tests/README.md لفهم عملية الاختبار، وضمان جودة التعليمات البرمجية.
• متطلبات الترخيص: يجب أن تتبع جميع المساهمات ترخيص GPL v2 أو أعلى.

موارد ذات صلة

• مستودع GitHub: https://github.com/Automattic/wordpress-mcp
• العميل البعيد: https://github.com/Automattic/mcp-wordpress-remote
• موقع WordPress MCP الرسمي: https://mcp-wp.github.io