Alpaca MCP Server

Alpaca MCP Server

这是一个适用于 Alpaca 的模型上下文协议（MCP）服务，可让 Claude 等大模型与 Alpaca 交易 API 交互。它支持通过自然语言交易股票、查看持仓、获取市场数据和管理账户。

功能

• 📊 市场数据 - 获取实时股票报价和历史价格数据
• 💵 账户信息 - 查看余额、购买力和账户状态
• 📈 持仓管理 - 查看当前持仓及其表现
• 🛒 下单 - 通过自然语言提交市价单和限价单
• 📋 订单管理 - 列出、跟踪和取消订单

前提条件

• 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
   

用法

运行服务

运行以下命令启动服务：

python alpaca_mcp_server.py

配置 Claude for Desktop

1. 打开 Claude for Desktop
2. 前往“设置”
3. 点击“Developer”，然后点击“Edit Config”
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