خادم iFly-Spark-Agent-MCP

ماذا يفعل خادم “iFly-Spark-Agent-MCP” MCP؟

خادم iFly-Spark-Agent-MCP MCP هو مثال تطبيقي بسيط يربط المساعدين الذكاء الاصطناعي بمنصة iFlytek SparkAgent باستخدام بروتوكول Model Context Protocol (MCP). يعمل هذا الخادم كجسر، حيث يسمح لعملاء الذكاء الاصطناعي باستدعاء سلاسل المهام على منصة SparkAgent من خلال واجهة موحدة. من خلال إتاحة أدوات مثل رفع الملفات، يوفر تكاملًا سلسًا للذكاء الاصطناعي لمهام مثل إدارة الملفات، أتمتة العمليات، وتنسيق سير العمل. تم تصميم الخادم لتعزيز سير عمل التطوير من خلال تسهيل الاتصال بين المساعدين الذكاء الاصطناعي وإمكانات SparkAgent، مما يجعل من الأسهل على المطورين إضافة وظائف متقدمة لتطبيقاتهم.

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

لم يتم ذكر قوالب مطالبات في المستودع.

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

لم يتم ذكر أو وصف موارد صريحة في المستودع.

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

• upload_file
  يتيح للعملاء رفع ملف عن طريق تحديد مسار الملف. تُمكن هذه الأداة عملاء الذكاء الاصطناعي من إدارة الملفات وإرسالها إلى منصة SparkAgent لمزيد من المعالجة أو تنفيذ سير العمل.

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

• رفع وإدارة الملفات
  يمكن للمطورين استخدام أداة upload_file لنقل الملفات المحلية إلى منصة SparkAgent، مما يتيح أتمتة سير العمل القائم على الملفات أو بدء خطوط معالجة.
• استدعاء سلسلة المهام
  يتيح الخادم لعملاء الذكاء الاصطناعي تشغيل سلاسل المهام على منصة SparkAgent، لتبسيط العمليات المعقدة التي تتطلب تنسيق عدة خطوات أو خدمات.
• التكامل مع أدوات تطوير الذكاء الاصطناعي
  بدعم MCP، يمكن دمج الخادم مع بيئات تطوير الذكاء الاصطناعي مثل Claude وCursor وWindsurf، مما يسهل ربط تطبيقات الذكاء الاصطناعي بإمكانات SparkAgent.
• تنفيذ سير العمل المؤتمت
  يمكن للمطورين أتمتة المهام المتكررة أو العمليات الدُفعية من خلال استدعاء سير عمل SparkAgent برمجيًا عبر واجهة خادم MCP.

كيفية الإعداد

Windsurf

لم يتم العثور على تعليمات محددة لـ Windsurf.

Claude

1. تأكد من المتطلبات الأساسية:
   • تثبيت Node.js وuv أو uvx.
   • استنساخ أو تحميل مستودع iFly-Spark-Agent-MCP.
2. حدد وافتح ملف claude_desktop_config.json أو mcp.json.
3. أضف الخادم باستخدام أي من الطريقتين:

باستخدام uv:

{
  "mcpServers": {
    "ifly-spark-agent-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/ifly-spark-agent-mcp",
        "run",
        "ifly-spark-agent-mcp"
      ],
      "env": {
        "IFLY_SPARK_AGENT_BASE_URL": "xxxx",
        "IFLY_SPARK_AGENT_APP_ID": "xxxx",
        "IFLY_SPARK_AGENT_APP_SECRET": "xxxx"
      }
    }
  }
}

باستخدام uvx مع مستودع GitHub:

{
  "mcpServers": {
    "ifly-spark-agent-mcp": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/iflytek/ifly-spark-agent-mcp",
        "ifly-spark-agent-mcp"
      ],
      "env": {
        "IFLY_SPARK_AGENT_BASE_URL": "xxxx",
        "IFLY_SPARK_AGENT_APP_ID": "xxxx",
        "IFLY_SPARK_AGENT_APP_SECRET": "xxxx"
      }
    }
  }
}

4. احفظ ملف التكوين وأعد تشغيل Claude.
5. تحقق من الإعداد عن طريق عرض الأدوات المتاحة أو تنفيذ أمر اختبار.

تأمين مفاتيح API

قم بتخزين المفاتيح الحساسة في قسم env:

"env": {
  "IFLY_SPARK_AGENT_BASE_URL": "xxxx",
  "IFLY_SPARK_AGENT_APP_ID": "xxxx",
  "IFLY_SPARK_AGENT_APP_SECRET": "xxxx"
}

Cursor

لم يتم العثور على تعليمات محددة لـ Cursor.

Cline

لم يتم العثور على تعليمات محددة لـ Cline.

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

استخدام MCP في FlowHunt

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

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

{
  "ifly-spark-agent-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

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

نظرة عامة

استنادًا إلى التوثيق المتاح، يوفر هذا الخادم MCP وظيفة أساسية فقط، تتركز بشكل أساسي حول أداة واحدة (upload_file). يشمل إرشادات إعداد مباشرة ومعلومات ترخيص مناسبة، لكنه يفتقر إلى ميزات متقدمة، وقوالب مطالبات، وتعريفات موارد. نطاقه محدود لكنه واضح، ومثالي كمثال عملي بسيط. بشكل عام، يُصنف بأنه منخفض إلى متوسط من حيث الشمولية والعمق.

تقييم MCP