Alpaca Trading

🚀 Alpaca MCP 服務器

Alpaca MCP 服務器是專為 Alpaca 設計的模型上下文協議（MCP）服務器。它能讓像 Claude 這類大語言模型（LLLM）通過與 Alpaca 交易 API 對接實現交互。藉助該服務器，你可以通過自然語言完成股票交易、查看持倉、獲取市場數據以及管理賬戶等操作。

🚀 快速開始

Alpaca MCP 服務器可助力大語言模型與 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，您可以提出以下問題：

• 查看我的賬戶餘額。
• 列出當前所有持倉。
• 獲取 Apple 股票的即時報價。
• 下達買入 Google 股票的市價單。

📚 詳細文檔

⚠️ 重要提示

• 默認情況下，服務器使用模擬交易環境。如需切換至真實交易，請參考相關文檔。
• 請謹慎處理 API 憑證信息，確保賬戶安全。

📄 許可證