alpaca-mcp-server

Alpaca MCP Server est un serveur officiel Model Context Protocol pour les API Trading et Market Data d'Alpaca. Il permet aux assistants et IDE compatibles MCP—notamment Claude Desktop, Claude Code, Cursor, VS Code, PyCharm et Antigravity—de découvrir les outils Alpaca et d'effectuer des tâches de trading ou de recherche via des requêtes en langage naturel. La version 2 est une réécriture complète construite avec FastMCP et OpenAPI. Elle n'est pas rétrocompatible avec la v1 : les noms d'outils, paramètres, schémas et la configuration ont changé, donc les installations mises à niveau doivent être reconfigurées, les clients redémarrés et de nouvelles sessions démarrées. La V1 peut rester épinglée à la dernière version 1.x si nécessaire. Le serveur s'exécute localement via stdio avec uvx, ou peut être construit et exécuté avec Docker. La configuration est fournie via des variables d'environnement dans la configuration du client MCP : ALPACA_API_KEY et ALPACA_SECRET_KEY sont requis, ALPACA_PAPER_TRADE vaut true par défaut, et ALPACA_TOOLSETS peut restreindre les capacités exposées. Le README met en garde contre l'exposition directe du serveur à l'internet public car il ne fournit pas lui-même d'authentification MCP distante. Les capacités exposées sont organisées en ensembles d'outils pour les informations de compte et de portefeuille, le trading, les positions, les listes de suivi, les actifs et l'état du marché, les données sur les actions, les données crypto, les données sur les options, les opérations sur titres, les actualités, les données sur les titres à revenu fixe et les localisations de vente à découvert. Les opérations spécifiques incluent la consultation des soldes et du pouvoir d'achat, la récupération de l'historique du portefeuille et des activités du compte, le passage d'ordres sur actions/ETF, crypto et options, le remplacement ou l'annulation d'ordres, la consultation ou la clôture de positions, l'exercice d'options et la gestion des listes de suivi. Les outils de données de marché couvrent les barres historiques et les plus récentes, les cotations, les transactions, les snapshots, les carnets d'ordres, les chaînes d'options, les Greeks, la volatilité implicite, les calendriers, les horloges, les annonces d'opérations sur titres, les actualités et les cotations de titres à revenu fixe. Le serveur inclut également des outils de consultation de documentation pour les guides Alpaca et les références des endpoints OpenAPI. Certaines capacités de données et de localisation dépendent de l'abonnement Alpaca ou de l'éligibilité d'un compte réel. Le projet documente la configuration pour plusieurs clients MCP, la configuration du trading en réel, le filtrage des ensembles d'outils, des exemples de prompts et une suite de tests contenant des contrôles d'intégrité, des tests de construction du serveur, des tests d'intégration de l'API paper et des tests d'intégration de la documentation.