منصوبے کے بارے میں

Alpaca MCP سرور Alpaca کے ٹریڈنگ اور مارکیٹ ڈیٹا APIs کے لیے ایک سرکاری ماڈل کانٹیکسٹ پروٹوکول سرور ہے۔ یہ MCP-مطابق اسسٹنٹس اور IDEs—بشمول Claude Desktop، Claude Code، Cursor، VS Code، PyCharm اور Antigravity—کو Alpaca کے ٹولز دریافت کرنے اور قدرتی زبان کی درخواستوں کے ذریعے ٹریڈنگ یا تحقیق کے کام انجام دینے کی اجازت دیتا ہے۔ ورژن 2 FastMCP اور OpenAPI کے ساتھ بنایا گیا ایک مکمل دوبارہ تحریر ہے۔ یہ v1 کے ساتھ پسماندہ مطابقت نہیں رکھتا: ٹول کے نام، پیرامیٹرز، اسکیمز اور کنفیگریشن تبدیل ہو گئی ہے، اس لیے اپ گریڈ شدہ انسٹالیشنز کو دوبارہ ترتیب دینا، کلائنٹس کو دوبارہ شروع کرنا اور نئے سیشن شروع کرنا ضروری ہے۔ اگر ضرورت ہو تو V1 کو آخری 1.x ریلیز پر پن کیا جا سکتا ہے۔ سرور مقامی طور پر stdio پر uvx کے ذریعے چلتا ہے، یا Docker کے ساتھ بنایا اور چلایا جا سکتا ہے۔ کنفیگریشن MCP کلائنٹ کنفیگریشن میں ماحولیاتی متغیرات کے ذریعے فراہم کی جاتی ہے: ALPACA_API_KEY اور ALPACA_SECRET_KEY ضروری ہیں، ALPACA_PAPER_TRADE بطور ڈیفالٹ true ہے، اور ALPACA_TOOLSETS ظاہر شدہ صلاحیتوں کو محدود کر سکتا ہے۔ README سرور کو براہ راست عوامی انٹرنیٹ پر ظاہر کرنے کے خلاف خبردار کرتا ہے کیونکہ یہ خود ریموٹ MCP تصدیق فراہم نہیں کرتا۔ ظاہر شدہ صلاحیتیں اکاؤنٹ اور پورٹ فولیو معلومات، ٹریڈنگ، پوزیشنز، واچ لسٹس، اثاثے اور مارکیٹ کی حیثیت، اسٹاک ڈیٹا، کرپٹو ڈیٹا، آپشنز ڈیٹا، کارپوریٹ ایکشنز، خبریں، فکسڈ انکم ڈیٹا اور شارٹ سیل لوکیٹس کے لیے ٹول سیٹس میں منظم ہیں۔ مخصوص کارروائیوں میں بیلنس اور خریداری کی طاقت دیکھنا، پورٹ فولیو کی تاریخ اور اکاؤنٹ کی سرگرمیاں حاصل کرنا، اسٹاک/ETF، کرپٹو اور آپشن آرڈر دینا، آرڈر تبدیل یا منسوخ کرنا، پوزیشنز دیکھنا یا بند کرنا، آپشنز استعمال کرنا اور واچ لسٹس کا انتظام کرنا شامل ہے۔ مارکیٹ ڈیٹا کے ٹولز تاریخی اور تازہ ترین بارز، کوٹس، ٹریڈز، سنیپ شاٹس، آرڈر بکس، آپشن چینز، Greeks، مضمر اتار چڑھاؤ، کیلنڈرز، کلاک، کارپوریٹ ایکشن اعلانات، خبریں اور فکسڈ انکم کوٹس کا احاطہ کرتے ہیں۔ سرور میں Alpaca گائیڈز اور OpenAPI اینڈ پوائنٹ حوالوں کے لیے دستاویزات تلاش کرنے کے ٹولز بھی شامل ہیں۔ کچھ ڈیٹا اور لوکیٹ صلاحیتیں Alpaca سبسکرپشن یا لائیو اکاؤنٹ کی اہلیت پر منحصر ہیں۔ یہ پروجیکٹ متعدد MCP کلائنٹس کے لیے سیٹ اپ، لائیو ٹریڈنگ کنفیگریشن، ٹول سیٹ فلٹرنگ، مثال کے پرامپٹس اور ایک ٹیسٹ سویٹ دستاویز کرتا ہے جس میں سالمیت کی جانچ، سرور کی تعمیر کے ٹیسٹ، پیپر API انٹیگریشن ٹیسٹ اور دستاویزات انٹیگریشن ٹیسٹ شامل ہیں۔