Alpaca Trading API

基本能力

产品定位

Alpaca MCP Server 是一个金融交易服务，通过自然语言接口实现股票交易和账户管理。

核心功能

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

适用场景

• 通过自然语言进行股票交易
• 实时查看市场数据和账户信息
• 管理投资组合和订单

工具列表

• 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 的模拟交易，如需真实交易，需将 TradingClient 初始化中的 paper=True 改为 paper=False
• 该服务会访问您的 Alpaca 账户并执行真实交易，请在批准任何交易前仔细检查 Claude 的建议

使用教程

使用依赖

• Python 3.10+
• Alpaca API keys
• Claude for Desktop 或其他 MCP 客户端

安装教程

1. 克隆仓库:

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

1. 安装依赖包:

   pip install mcp alpaca-py python-dotenv

1. 创建 .env 文件并添加 Alpaca API 凭证:

   API_KEY_ID=your_alpaca_api_key
   API_SECRET_KEY=your_alpaca_secret_key

调试方式

1. 启动服务器:

   python alpaca_mcp_server.py

1. 配置 Claude for Desktop:

- 打开 Claude for Desktop - 进入设置 - 点击 "Developer" 然后 "Edit Config" - 添加服务器配置到 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"
         }
       }
     }
   }

- 保存并重启 Claude for Desktop