इस प्रोजेक्ट के बारे में

Alpaca MCP Server, Alpaca के Trading और Market Data API के लिए एक आधिकारिक Model Context Protocol सर्वर है। यह MCP-संगत सहायकों और IDE—जिनमें Claude Desktop, Claude Code, Cursor, VS Code, PyCharm और Antigravity शामिल हैं—को Alpaca टूल्स खोजने और प्राकृतिक-भाषा अनुरोधों के माध्यम से ट्रेडिंग या शोध कार्य करने की अनुमति देता है। संस्करण 2, FastMCP और OpenAPI के साथ बनाया गया पूर्ण पुनर्लेखन है। यह v1 के साथ पश्चगामी संगत नहीं है: टूल नाम, पैरामीटर, स्कीमा और कॉन्फ़िगरेशन बदल गए हैं, इसलिए अपग्रेड किए गए इंस्टॉलेशन को पुनः कॉन्फ़िगर किया जाना चाहिए, क्लाइंट्स को पुनः आरंभ किया जाना चाहिए, और नए सत्र शुरू किए जाने चाहिए। यदि आवश्यक हो तो V1 को अंतिम 1.x रिलीज़ पर पिन किया जा सकता है। सर्वर uvx का उपयोग करके stdio पर स्थानीय रूप से चलता है, या Docker के साथ बनाया और चलाया जा सकता है। कॉन्फ़िगरेशन MCP क्लाइंट कॉन्फ़िगरेशन में पर्यावरण चर के माध्यम से प्रदान किया जाता है: ALPACA_API_KEY और ALPACA_SECRET_KEY आवश्यक हैं, ALPACA_PAPER_TRADE डिफ़ॉल्ट रूप से true है, और ALPACA_TOOLSETS उजागर क्षमताओं को प्रतिबंधित कर सकता है। README सर्वर को सीधे सार्वजनिक इंटरनेट पर उजागर करने के विरुद्ध चेतावनी देता है क्योंकि यह स्वयं रिमोट MCP प्रमाणीकरण प्रदान नहीं करता है। उजागर क्षमताएं खाता और पोर्टफोलियो जानकारी, ट्रेडिंग, पोज़िशन, वॉचलिस्ट, एसेट और मार्केट स्टेटस, स्टॉक डेटा, क्रिप्टो डेटा, ऑप्शंस डेटा, कॉर्पोरेट एक्शन, समाचार, फिक्स्ड-इनकम डेटा और शॉर्ट-सेल लोकेट के लिए टूलसेट में व्यवस्थित हैं। विशिष्ट ऑपरेशनों में बैलेंस और बाइंग पावर देखना, पोर्टफोलियो इतिहास और खाता गतिविधियां प्राप्त करना, स्टॉक/ETF, क्रिप्टो और ऑप्शन ऑर्डर देना, ऑर्डर बदलना या रद्द करना, पोज़िशन देखना या बंद करना, ऑप्शंस का प्रयोग करना और वॉचलिस्ट प्रबंधित करना शामिल है। मार्केट-डेटा टूल्स ऐतिहासिक और नवीनतम बार, कोट्स, ट्रेड्स, स्नैपशॉट, ऑर्डर बुक, ऑप्शन चेन, Greeks, इम्प्लाइड वोलैटिलिटी, कैलेंडर, क्लॉक, कॉर्पोरेट-एक्शन घोषणाएं, समाचार और फिक्स्ड-इनकम कोट्स को कवर करते हैं। सर्वर में Alpaca गाइड और OpenAPI एंडपॉइंट संदर्भों के लिए डॉक्यूमेंटेशन लुकअप टूल्स भी शामिल हैं। कुछ डेटा और लोकेट क्षमताएं Alpaca सदस्यता या लाइव-खाता पात्रता पर निर्भर करती हैं। परियोजना कई MCP क्लाइंट्स के लिए सेटअप, लाइव-ट्रेडिंग कॉन्फ़िगरेशन, टूलसेट फ़िल्टरिंग, उदाहरण प्रॉम्प्ट और एक टेस्ट सूट का दस्तावेज़ीकरण करती है जिसमें इंटीग्रिटी चेक, सर्वर-कंस्ट्रक्शन टेस्ट, पेपर-API इंटीग्रेशन टेस्ट और डॉक्यूमेंटेशन इंटीग्रेशन टेस्ट शामिल हैं।