/ الدليل / الملعب / Alpaca
← كل الخوادم ↗ GitHub
● رسمي alpacahq 🔑 يتطلب مفتاحك

Alpaca

بواسطة alpacahq · alpacahq/alpaca-mcp-server

دع كلود يبحث ويختبر استراتيجياته ويضع أوامر تداول للأسهم والصناديق والخيارات والعملات الرقمية عبر Alpaca — ابدأ بالحسابات الوهمية أولاً لتجنب خسائر حقيقية.

MCP Alpaca الرسمي يغلف API Alpaca للتداول وبيانات السوق. احصل على الأسعار والشموع والبيانات الأساسية والمراكز؛ ضع وعدّل وألغِ الأوامر. يستخدم الحسابات الوهمية افتراضياً، وهذا بالضبط كيف يجب أن تتعلم. انتقل إلى الحسابات الحقيقية فقط بعد إثبات نجاح استراتيجيتك.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

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

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

alpaca.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": [
        "alpaca-mcp-server"
      ]
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": [
        "alpaca-mcp-server"
      ]
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": [
        "alpaca-mcp-server"
      ]
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": [
        "alpaca-mcp-server"
      ]
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "alpaca",
      "command": "uvx",
      "args": [
        "alpaca-mcp-server"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "alpaca": {
      "command": {
        "path": "uvx",
        "args": [
          "alpaca-mcp-server"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add alpaca -- uvx alpaca-mcp-server

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

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

استخدامات عملية: Alpaca

إنشاء ملخص يومي قبل فتح السوق لقائمة مراقبتك

👤 المتداولون الأفراد النشطون ⏱ ~10 min beginner

متى تستخدمه: تريد فحص سريع في الصباح على 20 رمز قبل فتح السوق — التحركات الليلية، النتائج، الأخبار الواضحة.

المتطلبات الأساسية
  • حساب Alpaca (ورقي مجاني) — alpaca.markets → sign up → API keys on the dashboard
  • قائمة مراقبة الرموز — Plain list like [AAPL, MSFT, NVDA, ...]
الخطوات
  1. جلب بيانات الشموع الليلية
    For my watchlist [symbols], get yesterday's close and the latest pre-market quote. Compute % gap.✓ تم النسخ
    → Table: symbol, prev_close, pre_open, gap_pct
  2. علّم الحالات الشاذة
    Which tickers are gapping more than 2% in either direction? Rank by gap magnitude.✓ تم النسخ
    → Short 'needs attention' list
  3. أضف السياق
    For each outlier, pull the latest news headlines from Alpaca news endpoint.✓ تم النسخ
    → Per-ticker bullet with likely cause

النتيجة: ملخص يومي قبل السوق في شاشة واحدة، نفس الشكل كل يوم، بدون نقرات يدوية.

المزالق
  • بيانات السوق المجانية من IEX فقط وتتأخر؛ قد لا تطابق الأسعار وسيطك — مناسب لتحليل نهاية اليوم؛ إذا احتجت إلى SIP، قم بترقية خطة البيانات المدفوعة من Alpaca
اجمعها مع: notion

تطبيق استراتيجية بسيطة قائمة على القواعد في حساب وهمي

👤 المبتدئون في التداول الآلي ⏱ ~30 min intermediate

متى تستخدمه: لديك قاعدة مثل 'اشترِ SPY عندما يكون العائد 5 أيام < -3%، بيع بعد +2% أو 5 أيام تداول' وتريد تطبيقها على حساب وهمي.

المتطلبات الأساسية
  • مفاتيح الحساب الوهمي معدة — Use APCA_API_BASE_URL=https://paper-api.alpaca.markets
  • قاعدة مكتوبة — Entry, exit, position size, max loss — all explicit before coding anything
الخطوات
  1. تحقق من الحساب والمراكز
    Show my paper account equity, buying power, and current open positions.✓ تم النسخ
    → Clean account snapshot
  2. قيّم شروط الدخول اليوم
    Get SPY's last 5 daily bars. Compute 5-day return. If it's < -3% and I don't already hold SPY, place a market buy for $5000 notional. Otherwise do nothing.✓ تم النسخ
    → Either an order id or an explicit 'no action'
  3. سجّل قرار اليوم
    Append a row to /trades/journal.csv: date, condition_met, action, order_id, fill_price.✓ تم النسخ
    → Journal row written

النتيجة: تشغيل يومي قابل للمراجعة لاستراتيجية بسيطة على حساب وهمي، مع سجل يمكنك مراجعته.

المزالق
  • تشغيل عرضي مقابل مفاتيح حقيقية أثناء الاختبار — احتفظ بفحص واضح جداً في البداية: تأكد من أن رقم الحساب يطابق حسابك الوهمي قبل أي أمر
  • كلود ينسى موضع الأمس ويشتري مرتين — احصل دائماً على المراكز الحالية قبل تقييم الدخول؛ لا تعتمد على الذاكرة
اجمعها مع: filesystem

إعادة توازن المحفظة إلى التخصيصات المستهدفة

👤 المستثمرون الذين يديرون محافظهم بأنفسهم والذين لديهم تخصيص مستهدف ⏱ ~20 min intermediate

متى تستخدمه: ربع سنوي: أعد 60/30/10 (أمريكي/دولي/سندات) إلى الهدف دون حساب عدد الأسهم يدوياً.

المتطلبات الأساسية
  • التخصيص المستهدف معرّف — e.g. VTI 60%, VXUS 30%, BND 10%
الخطوات
  1. قياس الانحراف
    Get my positions and current prices. Compute current weight per symbol vs target [paste targets]. Show drift in $ and %.✓ تم النسخ
    → Per-symbol drift table
  2. اقترح التداولات
    Propose the minimum set of buys/sells to bring weights within 1% of target. Show expected commissions (likely $0) and estimated slippage.✓ تم النسخ
    → Order plan
  3. نفّذ مع التأكيد
    Before placing: summarize the plan in 3 lines and wait for my 'yes'. On yes, submit as market-on-open orders.✓ تم النسخ
    → Orders placed with ids; equity matches target within 1%

النتيجة: إعادة توازن ربع سنوية نظيفة مع سجل مكتوب لسبب كل تداول.

المزالق
  • الحساب الخاضع للضريبة: كل إعادة توازن تؤدي إلى مكاسب/خسائر — فضّل إعادة توازن المساهمات الجديدة أو الخروج مع الوعي بكمية الضريبة؛ قم بالتشغيل فقط في IRA إذا كنت غير متأكد
اجمعها مع: filesystem

مسح سلسلة الخيارات للعثور على عائد بيع الخيارات البائعة قصيرة الأجل

👤 متداولو الدخل من الخيارات (البيع الآمن للخيارات البائعة / المكالمات المغطاة) ⏱ ~25 min advanced

متى تستخدمه: تريد العثور على أفضل خيار بائع آمن للبيع على الرموز التي ستكون سعيداً بامتلاكها، أسبوعياً.

المتطلبات الأساسية
  • حساب Alpaca مفعّل للخيارات — Enable in account settings; paper works for learning
الخطوات
  1. احصل على السلسلة واليونانيين
    Get the options chain for [ticker] expiring next Friday, puts only, strikes within 5% of spot. Include bid, ask, mid, delta, IV.✓ تم النسخ
    → Chain table
  2. صنّف حسب العائد السنوي
    Compute annualized return-on-cash for each strike assuming assignment. Filter delta between -0.15 and -0.30. Rank top 5.✓ تم النسخ
    → Ranked short list
  3. ضع أمر بيع بفتح بسعر محدد في الوسط
    Place a sell-to-open limit order for 1 contract of the #1 strike at the mid. GTC, day-only.✓ تم النسخ
    → Order id returned

النتيجة: روتين دخل أسبوعي قابل للتكرار مع فحص مخاطر محافظ.

المزالق
  • بيع خيارات بائعة على شركات لا تريد امتلاكها — قاعدة صارمة: طبّق هذه الاستراتيجية فقط على 10 رموز وافقت عليها مسبقاً كمحافظ طويلة الأجل
  • الضربات غير السائلة برفق عرض-طلب ضخم — التنفيذ لا يحدث أبداً بسعر الوسط — فلتّر من أجل open_interest > 500 و spread < 5% من الوسط قبل التصنيف
اجمعها مع: notion

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

alpaca + notion

ملخص يومي قبل السوق يُسلّم إلى صفحة Notion

Run my pre-market scan for watchlist and create a Notion page in 'Trading / Daily' with the results.✓ تم النسخ
alpaca + filesystem

دفتر التداول: أضف كل أمر والسبب إلى ملف CSV محلي

After any place_order, append {ts, symbol, side, qty, reason} to /trading/journal.csv.✓ تم النسخ
alpaca + postgres

خزّن منحنى الأسهم اليومي لاختبار الاستراتيجيات

Every evening, INSERT today's account equity into the equity_curve table.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
get_account أول استدعاء في أي جلسة — تأكد من أنك على حساب وهمي مقابل حقيقي free
get_positions تحقق من المراكز الحالية قبل أي منطق دخول free
get_bars symbol, timeframe, start, end, limit? OHLCV التاريخي للتحليل والإشارات free (IEX) or paid (SIP)
get_latest_quote symbol السعر الفوري قبل وضع أمر free
place_order symbol, qty|notional, side, type, time_in_force, limit_price? قدّم أمر جديد (ابدأ دائماً بالحساب الوهمي) free (commission-free)
cancel_order order_id ألغِ أمر مفتوح قبل تنفيذه free
get_options_chain underlying, expiration, side? امسح الضربات لاستراتيجية خيارات free on Alpaca

التكلفة والحدود

تكلفة التشغيل

حصة API
200 req/min على API البيانات (الطبقة المجانية)؛ API التداول فعلياً بدون حد على نطاق التجزئة
الرموز لكل استدعاء
الحساب/المراكز: 200–500 رموز. الشموع: يتغير مع الحد.
التكلفة المالية
Alpaca بدون عمولة. خطة البيانات المدفوعة ~$9/شهر لـ SIP؛ تغذية IEX المجانية مناسبة لمعظم الاستخدام بالتجزئة.
نصيحة
اختبر كل استراتيجية جديدة على حساب وهمي لمدة 4 أسابيع على الأقل قبل لمس أموال حقيقية. إنها مجانية.

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: مفتاح API الحساب + السر — Alpaca لا يملك نطاقات فرعية
تخزين بيانات الاعتماد: APCA_API_KEY_ID, APCA_API_SECRET_KEY, and APCA_API_BASE_URL in env vars
نقل البيانات الخارجي: All calls to api.alpaca.markets or paper-api.alpaca.markets
لا تمنح أبدًا: مشاركة المفاتيح الحقيقية مع أي خدمة طرف ثالث، بما فيها منصات الكود

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

403 forbidden.insufficient-permissions

مفاتيحك للبيئة الخاطئة (حقيقية مقابل وهمية). طابق APCA_API_BASE_URL مع زوج المفاتيح.

تحقق: curl -H 'APCA-API-KEY-ID: ...' -H 'APCA-API-SECRET-KEY: ...' $APCA_API_BASE_URL/v2/account
422 buying_power insufficient

حسابك الوهمي تم إعادة تعيينه، أو حجّمت التداول بأكثر من النقود. استدعِ get_account وأعد حساب حجم المركز.

Bars return empty for recent timestamp

تغذية IEX لديها تأخير ~15 دقيقة على الطبقة المجانية، ولا تخدم كل رمز. استخدم SIP أو انتظر.

Order rejected: market closed

TIF الافتراضي هو day؛ الأوامر المغلقة بالسوق تحتاج إلى time_in_force='opg' أو 'cls' أو التبديل إلى ساعات ممتدة مع extended_hours=true على الأوامر المحدودة.

البدائل

Alpaca مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Interactive Brokers MCPتحتاج إلى أسواق دولية أو عقود آجلةمصادقة أكثر تعقيداً (تطبيق البوابة مطلوب)؛ منحنى التعلم
Polygon.io MCPتحتاج فقط إلى بيانات السوق، لا تداوللا توجد تنفيذ الأوامر؛ يتطلب الدفع للحصول على التغطية الكاملة

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills