Alpaca MCP Server

基本能力

产品定位

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 密钥
• Claude for Desktop 或其他 MCP 客户端

安装教程

1. 克隆仓库： bash git clone https://github.com/YOUR_USERNAME/alpaca-mcp.git cd alpaca-mcp

2. 安装所需包： bash 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

调试方式

1. 启动服务器： bash python alpaca_mcp_server.py

2. 配置 Claude for Desktop：

3. 打开 Claude for Desktop
4. 进入设置
5. 点击"Developer"然后"Edit Config"
6. 在 claude_desktop_config.json 中添加服务器配置
7. 保存并重启 Claude for Desktop

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。