Alpaca MCP Server

🚀 Alpaca MCP 服務器

這是一個用於 Alpaca 的模型上下文協議 (MCP) 服務器，它能讓像 Claude 這樣的大型語言模型 (LLMs) 與 Alpaca 的交易 API 進行交互。藉助該服務器，用戶能夠通過自然語言實現股票交易、查看持倉、獲取市場數據以及管理賬戶等操作，極大地提升了交易的便捷性。

🚀 快速開始

Alpaca MCP 服務器允許大型語言模型與 Alpaca 的交易 API 交互，支持通過自然語言進行股票交易、查看持倉等操作。以下為您介紹使用步驟。

運行服務器

通過運行以下命令啟動服務器：

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。

示例查詢

一旦服務器連接到 Claude，您可以提出以下問題：

• “當前我的賬戶餘額和購買力是多少？”
• “顯示我當前的持倉”
• “獲取 AAPL 的最新行情”
• “顯示 TSLA 過去 10 天的價格走勢”
• “買入 5 股 MSFT 按市價成交”
• “賣出 10 股 TSLA，價格為 X”
• “取消所有未成交訂單”

✨ 主要特性

• 📊 市場數據 - 獲取即時股票報價和歷史價格數據。
• 💵 賬戶信息 - 查看餘額、購買力和賬戶狀態。
• 📈 持倉管理 - 查看當前持倉及其表現。
• 🛒 訂單下單 - 通過自然語言下單市價單和限價單。
• 📋 訂單管理 - 列出、跟蹤和取消訂單。

📦 安裝指南

先決條件

• 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. 創建一個 .env 文件，添加您的 Alpaca API 憑據：

API_KEY_ID=your_alpaca_api_key
API_SECRET_KEY=your_alpaca_secret_key

💻 使用示例

基礎用法

服務器公開以下工具，您可以在代碼中使用它們：

# 獲取賬戶信息
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)

📚 詳細文檔

注意事項

⚠️ 重要提示

此服務器需要有效的 Alpaca API 密鑰才能正常運行。建議在生產環境中使用此工具時仔細審查代碼並確保安全性。

安全提示

💡 使用建議

始終審查通過此服務器發送的指令，以防止未經授權的交易或操作。