عن المشروع

خادم Spec Workflow MCP هو خادم بروتوكول سياق النموذج (MCP) يضيف سير عمل تطوير منظمًا قائمًا على المواصفات إلى البرمجة بمساعدة الذكاء الاصطناعي. بدلاً من ترك المساعد يقفز مباشرة إلى الكود، يوجه العمل عبر مستندات مواصفات تسلسلية: المتطلبات، ثم التصميم، ثم المهام. يتم توزيعه كحزمة npm (@pimzino/spec-workflow-mcp) ويتم تكوينه كخادم MCP داخل أدوات مثل Claude Code وClaude Desktop وCursor وWindsurf وCline وContinue وAugment Code وOpenCode وCodex. القدرات الأساسية الموصوفة في ملف README: - سير عمل منظم: يتم إنشاء المواصفات بالترتيب (المتطلبات ← التصميم ← المهام)، ويمكن تنفيذ المهام الفردية بالاسم أو الرقم عبر مطالبات المحادثة. - لوحة معلومات ويب في الوقت الفعلي: عملية لوحة معلومات (المنفذ الافتراضي 5000) تعرض المواصفات والمهام وأشرطة التقدم والحالة، مع تحديثات مباشرة. يمكن لنسخة واحدة من اللوحة خدمة مشاريع متعددة. - امتداد VSCode: لوحة جانبية مدمجة لمستخدمي VSCode، منشورة على Visual Studio Marketplace. - سير عمل الموافقة: يمكن تقديم المستندات للموافقة عبر اللوحة، مع تتبع الملاحظات والمراجعات. - تتبع تقدم المهام: مؤشرات تقدم مرئية وحالة تفصيلية للمهام. - سجلات التنفيذ: سجلات قابلة للبحث لتنفيذ المهام بما في ذلك إحصائيات الكود. - دعم متعدد اللغات: يوفر المشروع وثائق بـ 11 لغة (الإنجليزية، اليابانية، الصينية، الإسبانية، البرتغالية، الألمانية، الفرنسية، الروسية، الإيطالية، الكورية والعربية). الاستخدام يعتمد على المطالبات: يذكر المستخدمون spec-workflow في المحادثة لإنشاء مواصفة أو قائمة المواصفات أو تنفيذ مهمة محددة. تعيش حالة المشروع في دليل .spec-workflow يحتوي على الموافقات والأرشيف والمواصفات والتوجيه والقوالب وقوالب المستخدم. النشر والعمليات: يمكن تشغيل اللوحة في Docker عبر Dockerfile وdocker-compose المقدمين، مع تركيب وحدة تخزين لمنطقة عمل .spec-workflow. تشير ملاحظات الأمان في README إلى أن الخادم يرتبط بـ 127.0.0.1 افتراضيًا، ويطبق تحديد المعدل (120 طلبًا/دقيقة لكل عميل)، ويكتب سجلات تدقيق JSON منظمة، ويضبط رؤوس الأمان، ويقيد CORS على localhost، ويقوي صورة Docker بمستخدم غير جذري، ونظام ملفات للقراءة فقط، وإمكانيات محذوفة وحدود للموارد. تم إدراج HTTPS/TLS ومصادقة المستخدم صراحةً على أنهما غير منفذين بعد، مع توصية باستخدام الخوادم الوسيطة العكسية (nginx/Apache) للوصول الخارجي. للبيئات المعزولة حيث $HOME للقراءة فقط، يوجه متغير البيئة SPEC_WORKFLOW_HOME الحالة العامة إلى موقع قابل للكتابة. التطوير يتم عبر npm (تثبيت، بناء، برامج تطوير)، والمشروع مرخص بموجب GPL-3.0. يذكر README أيضًا أن المشرف أخذ استراحة مؤقتة من المستودع.