تكامل خادم 1Panel MCP

ماذا يفعل خادم “1Panel” MCP؟

يعد خادم 1Panel MCP تنفيذًا لبروتوكول Model Context Protocol (MCP) مصمم خصيصًا للتكامل مع 1Panel. يعمل كجسر بين المساعدات الذكية ومنصة 1Panel، مما يعزز سير العمل التطويري من خلال تمكين وكلاء الذكاء الاصطناعي من التفاعل برمجيًا مع واجهات برمجة تطبيقات 1Panel ومصادر بياناتها. من خلال نشر هذا الخادم، يمكن للمطورين استخدام أدوات مدعومة بالذكاء الاصطناعي لأتمتة وتبسيط المهام الإدارية والتشغيلية الشائعة في بيئات 1Panel الخاصة بهم، مثل الاستعلام عن حالة النظام، وإدارة الملفات، أو تنفيذ أوامر التحكم. يدعم الخادم عدة طرق نقل (stdio وsse) مما يوفر مرونة للتكامل في بيئات متعددة، ويمكن تكوينه بأمان باستخدام رموز API وعناوين المضيف.

قائمة القوالب

لا توجد قوالب مطالبات مذكورة في التوثيق أو الكود المتوفر.

قائمة الموارد

لا توجد موارد MCP صريحة موصوفة في التوثيق أو الكود المتوفر.

قائمة الأدوات

لا توجد أدوات محددة مدرجة أو موصوفة في التوثيق أو الكود المتوفر (على سبيل المثال، ملف server.py غير موجود في هذا المشروع المبني بلغة Go).

حالات استخدام هذا الخادم MCP

• أتمتة 1Panel: دمج مساعدات الذكاء الاصطناعي لأتمتة مهام 1Panel الإدارية مثل إعادة تشغيل الخدمات، إدارة المستخدمين، أو فحص الحالة عبر أوامر AI موحدة.
• العمليات عن بُعد: تمكين البرامج النصية أو سير العمل المدفوع بالذكاء الاصطناعي من التفاعل مع خوادم 1Panel عن بعد، مما يعزز قدرات DevOps وإدارة الأنظمة.
• تكامل الذكاء الاصطناعي مع البث/التدفق SSE: تمكين التفاعل الفوري بين 1Panel ووكلاء الذكاء الاصطناعي باستخدام وضع نقل SSE، مما يسمح بالمراقبة المباشرة والاستجابة السريعة.
• وصول مبرمج آمن: استخدام رموز الوصول والإعدادات البيئية للكشف الآمن فقط عن أجزاء 1Panel الضرورية لوكلاء الذكاء الاصطناعي، مع الحفاظ على سلامة التشغيل.

كيفية إعداده

Windsurf

1. تأكد من توفر ملف خادم 1Panel MCP التنفيذي أو صورة Docker.

2. احصل على رمز الوصول الخاص بك لـ 1Panel وعنوان المضيف.

3. حرر ملف إعدادات Windsurf.

4. أضف المقطع التالي من JSON تحت mcpServers:

   {
     "mcpServers": {
       "mcp-1panel": {
         "command": "mcp-1panel",
         "env": {
           "PANEL_ACCESS_TOKEN": "<your 1Panel access token>",
           "PANEL_HOST": "مثل http://localhost:8080"
         }
       }
     }
   }
   

5. احفظ وأعد تشغيل Windsurf، ثم تحقق من اتصال الخادم.

مثال Docker

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PANEL_HOST",
        "-e",
        "PANEL_ACCESS_TOKEN",
        "1panel/1panel-mcp-server"
      ],
      "env": {
        "PANEL_HOST": "مثل http://localhost:8080",
        "PANEL_ACCESS_TOKEN": "<your 1Panel access token>"
      }
    }
  }
}

Claude

1. قم بتنزيل أو بناء خادم 1Panel MCP.
2. احصل على رمز API الخاص بك لـ 1Panel ومعلومات المضيف.
3. افتح ملف إعدادات Claude.
4. أدخل نفس الإعدادات كما في Windsurf تحت mcpServers.
5. احفظ وأعد تشغيل Claude.

Cursor

1. تأكد من تثبيت خادم 1Panel MCP.

2. احصل على رمز الوصول الخاص بك وعنوان المضيف.

3. حرر ملف إعدادات Cursor.

4. أضف:

   {
     "mcpServers": {
       "mcp-1panel": {
         "command": "mcp-1panel",
         "env": {
           "PANEL_ACCESS_TOKEN": "<your 1Panel access token>",
           "PANEL_HOST": "مثل http://localhost:8080"
         }
       }
     }
   }
   

5. احفظ التغييرات وأعد تشغيل Cursor.

مثال وضع SSE

إذا كنت تستخدم وضع SSE، شغّل الخادم بـ:

mcp-1panel -host http://localhost:8080 -token <your 1Panel access token> -transport sse -addr http://localhost:8000

أضف إلى mcpServers:

{
  "mcpServers": {
    "mcp-1panel": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Cline

1. ثبّت خادم 1Panel MCP.
2. عيّن متغيرات PANEL_ACCESS_TOKEN و PANEL_HOST.
3. حرر ملف إعدادات Cline وأدخل نفس JSON كما بالأعلى.
4. احفظ وأعد تشغيل Cline.

تأمين رموز API

احفظ رموز API والمعلومات الحساسة في متغيرات البيئة. مثال للإعدادات:

{
  "mcpServers": {
    "mcp-1panel": {
      "command": "mcp-1panel",
      "env": {
        "PANEL_ACCESS_TOKEN": "${PANEL_ACCESS_TOKEN}",
        "PANEL_HOST": "${PANEL_HOST}"
      }
    }
  }
}

استبدل ${PANEL_ACCESS_TOKEN} و${PANEL_HOST} بأسماء متغيرات البيئة لديك.

كيفية استخدام هذا MCP داخل التدفقات

استخدام MCP في FlowHunt

لدمج خوادم MCP ضمن سير عمل FlowHunt الخاص بك، ابدأ بإضافة مكون MCP إلى التدفق وربطه بوكيل الذكاء الاصطناعي الخاص بك:

انقر على مكون MCP لفتح لوحة الإعدادات. في قسم إعدادات النظام MCP، أدخل تفاصيل خادم MCP الخاص بك باستخدام هذا التنسيق من JSON:

{
  "MCP-name": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

بمجرد الإعداد، يصبح وكيل الذكاء الاصطناعي قادرًا على استخدام هذا MCP كأداة مع صلاحية الوصول لجميع وظائفه وإمكاناته. تذكر تغيير “MCP-name” إلى “mcp-1panel” واستبدال الرابط برابط خادم MCP الخاص بك.

نظرة عامة

رأينا

يوفر خادم 1Panel MCP تعليمات تثبيت وتكامل واضحة ويتم صيانته بنشاط مع عدد جيد من النجوم و"الفورك". ومع ذلك، فإن نقص الوصف التفصيلي للأدوات والقوالب والموارد في التوثيق يحد من قابليته للاستخدام مباشرة في سير عمل الذكاء الاصطناعي المعقدة. بناءً على ما سبق، نقيم هذا التنفيذ من MCP بـ 5/10 من حيث الشمولية وملاءمة المطورين.

تقييم MCP