تكامل خادم Alpaca MCP

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

خادم Alpaca MCP (بروتوكول سياق النماذج) هو طبقة تكامل متخصصة تتيح لمساعدي الذكاء الاصطناعي ونماذج اللغة الضخمة التفاعل مع منصة تداول Alpaca باستخدام أوامر اللغة الطبيعية. من خلال الاتصال عبر MCP، يمكن للمطورين والمستخدمين تداول الأسهم والخيارات، تحليل البيانات المالية، إدارة المحافظ، التعامل مع قوائم المراقبة، والوصول إلى معلومات السوق اللحظية مباشرة من أدوات LLM وبيئات التطوير المفضلة لديهم مثل Claude Desktop وCursor وVScode. يعمل هذا الخادم كحلقة وصل بين وكلاء الذكاء الاصطناعي وبنية التداول التحتية، مما يجعل المهام مثل تنفيذ الأوامر، جلب البيانات التاريخية، أو مراقبة قوائم الأصول أكثر سهولة وسلاسة من خلال واجهات محادثة، وبالتالي تبسيط سير العمل للتداول الخوارزمي والتحليل المالي وإدارة المحافظ.

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

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

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

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

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

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

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

• تداول الأسهم والخيارات
  استخدم اللغة الطبيعية لتنفيذ، تعديل وإلغاء صفقات الأسهم والخيارات مباشرة من واجهة مدعومة بـ LLM، مما يتيح سير عمل تداول خوارزمي ويدوي دون الحاجة للتنقل اليدوي في المنصة.

• إدارة المحافظ
  عرض أرصدة الحساب، مراجعة المراكز المفتوحة والمغلقة، وإدارة ممتلكاتك باستخدام أوامر محادثة لتسهيل الإشراف على المحفظة وإعادة التوزيع.

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

• إدارة قوائم المراقبة
  أنشئ وادِر قوائم مراقبة مخصصة لتتبع الأصول، مما يساعد المستخدمين على مراقبة عدة أوراق مالية والاستجابة لتغيرات السوق بكفاءة.

• تاريخ الأوامر وحالة السوق
  جلب سجل الأوامر بالكامل، تحقق من حالة السوق (مفتوح/مغلق)، واطلع على بيانات إجراءات الشركات (الأرباح، التجزئة، التوزيعات) لوعي شامل بالحساب والسوق.

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

Windsurf

لا توجد تعليمات خاصة بـ Windsurf في التوثيق أو الكود المتاح.

Claude

1. المتطلبات المسبقة:

   • تثبيت Python 3.10+
   • استنساخ المستودع وتثبيت المتطلبات
   • الحصول على مفاتيح API من Alpaca

2. إنشاء/تعديل ملف .env:
   أضف التالي إلى ملف .env في مجلد المشروع:

   ALPACA_API_KEY = "your_alpaca_api_key"
   ALPACA_SECRET_KEY = "your_alpaca_secret_key"
   PAPER = True
   

3. تشغيل خادم MCP:

   python alpaca_mcp_server.py
   

4. إعداد Claude Desktop:

   • افتح Claude Desktop
   • انتقل إلى: Settings → Developer → Edit Config
   • حدث ملف claude_desktop_config.json الخاص بك:

     {
       "mcpServers": {
         "alpaca": {
           "command": "<project_root>/venv/bin/python",
           "args": [
             "/path/to/alpaca-mcp-server/alpaca_mcp_server.py"
           ],
           "env": {
             "ALPACA_API_KEY": "your_alpaca_api_key",
             "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
           }
         }
       }
     }
     

5. احفظ الإعدادات وأعد تشغيل Claude Desktop

Cursor

لا توجد تعليمات خاصة بـ Cursor في التوثيق أو الكود المتاح.

Cline

لا توجد تعليمات خاصة بـ Cline في التوثيق أو الكود المتاح.

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

يتم تحديد مفاتيح الـ API باستخدام متغيرات البيئة كما هو موضح في قسم env من إعدادات JSON:

"env": {
  "ALPACA_API_KEY": "your_alpaca_api_key",
  "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
}

كيفية استخدام هذا 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 الفعلي الخاص بك (مثل “alpaca”، “github-mcp”، إلخ) واستبدال الرابط بعنوان خادم MCP الخاص بك.

نظرة عامة

بين هذين الجدولين، يقدم خادم Alpaca MCP توثيقاً قوياً للإعداد وحالات الاستخدام الأساسية، لكنه يفتقر إلى تفاصيل صريحة حول قوالب برومبت MCP، الأدوات المتوفرة، وتعريفات الموارد. هو مناسب جداً لسير عمل التداول وبيانات السوق، لكنه سيستفيد من توثيق MCP أكثر تفصيلاً. التقييم: 6/10.

تقييم MCP