Alpaca MCP Server

Este és un servidor Model Context Protocol (MCP) per a Alpaca, que permet a LLMs com Claude interactuar amb l'API de trading d'Alpaca. Facilita la compra i venda d'accions, la verificació de posicions, la recuperació de dades de mercat i la gestió del vostre compte, tot a través del llenguatge natural.

Funcionalitats

• 📊 Market Data - Obtén cotitzacions en temps real i dades històriques de preus
• 💵 Account Information - Consulta els teus saldos, poder d'adquisició i estat
• 📈 Position Management - Visualitza les posicions actuals i el seu rendiment
• 🛒 Order Placement - Realitza ordres de mercat i límit amb llenguatge natural
• 📋 Order Management - Llista, segueix i cancela ordres

Requisits previs

• Python 3.10+
• Claus API d'Alpaca
• Claude per a Desktop o un altre client MCP

Instal·lació

1. Clona aquest repositori:

   git clone https://github.com/YOUR_USERNAME/alpaca-mcp.git
   cd alpaca-mcp
   

2. Instal·la els paquets requerits:

   pip install mcp alpaca-py python-dotenv
   

3. Crea un fitxer .env amb les teves credencials API d'Alpaca:

   API_KEY_ID=your_alpaca_api_key
   API_SECRET_KEY=your_alpaca_secret_key
   

Ús

Executar el servidor

Inicia el servidor executant:

python alpaca_mcp_server.py

Configuració de Claude per a Desktop

1. Obre Claude per a Desktop
2. Ves a Configuració
3. Fes clic a "Developer" i després a "Edit Config"
4. Afegeix la configuració del servidor a claude_desktop_config.json:

{
  "mcpServers": {
    "alpaca": {
      "command": "python",
      "args": [
        "/path/to/alpaca_mcp_server.py"
      ],
      "env": {
        "API_KEY_ID": "your_alpaca_api_key",
        "API_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

5. Desa i reinicia Claude per a Desktop

Eines disponibles

El servidor expõe les següents eines:

• get_account_info() - Obtén els saldos i l'estat del compte
• get_positions() - Llista totes les posicions actuals del portafoli
• get_stock_quote(symbol) - Obtén la última cotització d'una acció
• get_stock_bars(symbol, days) - Obtén les barres de preus històriques d'una acció
• get_orders(status, limit) - Llista les ordres amb l'estat especificat
• place_market_order(symbol, side, quantity) - Realitza una ordre de mercat
• place_limit_order(symbol, side, quantity, limit_price) - Realitza una ordre de límit
• cancel_all_orders() - Cancela totes les ordres obertes
• close_all_positions(cancel_orders) - Tanca totes les posicions obertes

Consultes d'exemple

Un cop el servidor està connectat a Claude, pots preguntar:

• "Quin és el meu saldo actual i poder d'adquisició?"
• "Mostra'm les meves posicions actuals"
• "Obtén la última cotització de AAPL"
• "Mostra'm la història de preus de TSLA durant els últims 10 dies"
• "Compra 5 accions de MSFT a preu de mercat"
• "Vendes 10 accions d'AMZN amb un preu límit de $130"
• "Cancel·la totes les meves ordres obertes"

Nota

El servidor utilitza el trading de paper d'Alpaca per defecte. Per utilitzar trading amb diners reals, canvia paper=True a paper=False a l'inicialització del TradingClient.

Avís de seguretat

Aquest servidor MCP tindrà accés al teu compte d'Alpaca i pot realitzar operacions reals. Revisa sempre el que suggereix Claude abans d'aprovar qualsevol operació.

Licència

MIT