Miguelyad26 Alpaca MCP Server

🚀 Alpaca MCP 服務器

Alpaca MCP 服務器為 Alpaca 提供模型上下文協議（MCP），允許 Claude 等大語言模型與 Alpaca 的交易 API 交互。支持股票交易、持倉查看、市場數據獲取和賬戶管理等操作，且均可通過自然語言完成。

🚀 快速開始

本服務器允許大語言模型與 Alpaca 交易 API 交互，支持通過自然語言完成股票交易等操作。以下為你介紹使用前的準備與啟動步驟。

✨ 主要特性

• 📚 Alpaca 文檔訪問 - 可訪問 Alpaca SDK 文檔以進行開發。
• 📊 市場數據 - 能獲取即時股票報價和歷史價格數據。
• 💵 賬戶信息 - 可查看餘額、購買力和賬戶狀態。
• 📈 持倉管理 - 可查看當前持倉及其表現。
• 🛒 訂單下單 - 能通過自然語言下達市價單和限價單。
• 📋 訂單管理 - 可列出、跟蹤並取消訂單。

📦 安裝指南

先決條件

• Python 3.10+ 版本。
• Alpaca API 憑證。
• Claude for Desktop 或其他 MCP 客戶端。

安裝步驟

1. 克隆此倉庫：

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

2. 安裝所需的包：

   pip install mcp alpaca-py python-dotenv
   

3. 創建包含 Alpaca API 憑證的 .env 文件：

   API_KEY_ID=your_alpaca_api_key
   API_SECRET_KEY=your_alpaca_secret_key
   

💻 使用示例

運行服務器

啟動服務器，請運行以下命令：

python alpaca_mcp_server.py

配置 Claude for Desktop

1. 打開 Claude for Desktop。

2. 進入設置。

3. 點擊“開發者”然後選擇“編輯配置”。

4. 將服務器配置添加到 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. 保存並重啟 Claude for Desktop。

可用工具

服務器提供以下工具：

• get_account_info() - 獲取賬戶餘額和狀態。
• get_positions() - 列出當前持倉。
• get_stock_quote(symbol) - 獲取股票的最新行情。
• get_stock_bars(symbol, days) - 獲取股票的歷史價格數據。
• get_orders(status, limit) - 列出指定狀態的訂單。
• place_market_order(symbol, side, quantity) - 下達市價單。
• place_limit_order(symbol, side, quantity, limit_price) - 下達限價單。
• cancel_all_orders() - 取消所有未成交訂單。
• close_all_positions(cancel_orders) - 平倉所有持倉（可選：取消相關訂單）。

示例查詢

當服務器與 Claude 連接後，您可以提出以下問題：

• “我的當前賬戶餘額和購買力是多少？”
• “顯示我的當前持倉”
• “獲取AAPL的最新行情”
• “顯示TSLA過去10天的價格走勢”
• “買入5股微軟（MSFT）股票”
• “以130美元的限價賣出10股亞馬遜（AMZN）”
• “取消所有未成交訂單”

📚 詳細文檔

注意

該服務器默認使用 Alpaca 的模擬交易功能。如需使用真實資金進行交易，請在 TradingClient 初始化時將 paper=True 更改為 paper=False。

安全提示

此 MCP 服務器可以訪問您的 Alpaca 賬戶並能執行真實的交易操作。請務必仔細檢查 Claude 的建議，確保批准的交易符合預期。

📄 許可證

本項目採用 MIT 許可證。