Alpaca MCP Server
2025.05.06
0
Python金融交易股票交易账户管理金融服务
Alpaca MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，允许像 Claude 这样的 LLMs 通过自然语言与 Alpaca 交易 API 进行交互。它支持股票交易、查看持仓、获取市场数据以及管理账户等功能。
View on GitHub
Overview
基本能力
产品定位
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 客户端
安装教程
-
克隆仓库:
bash git clone https://github.com/YOUR_USERNAME/alpaca-mcp.git cd alpaca-mcp -
安装依赖包:
bash pip install mcp alpaca-py python-dotenv -
创建
.env文件并添加 Alpaca API 凭证:API_KEY_ID=your_alpaca_api_key API_SECRET_KEY=your_alpaca_secret_key
调试方式
-
启动服务器:
bash python alpaca_mcp_server.py -
配置 Claude for Desktop:
- 打开 Claude for Desktop
- 进入设置
- 点击 "Developer" 然后 "Edit Config"
- 添加服务器配置到
claude_desktop_config.json: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