🚀 Alpaca MCP 服务器
这是一个专为 Alpaca 设计的模型上下文协议 (MCP) 服务器，它能让像 Claude 这类大型语言模型 (LLMs) 与 Alpaca 的交易 API 进行交互。借助该服务器，用户可以通过自然语言实现股票交易、查看持仓、获取市场数据以及管理账户等操作，极大地提升了交易的便捷性。
🚀 快速开始
本服务器支持股票交易、查看持仓、获取市场数据、管理账户等功能，全部可通过自然语言实现。
✨ 主要特性
- 📊 市场数据 - 获取实时股票报价和历史价格数据
- 💵 账户信息 - 查看余额、购买力和账户状态
- 📈 持仓管理 - 查看当前持仓及其表现
- 🛒 订单下单 - 通过自然语言下单市价单和限价单
- 📋 订单管理 - 列出、跟踪和取消订单
📦 安装指南
先决条件
- Python 3.10+
- Alpaca API 密钥
- Claude for Desktop 或另一个 MCP 客户端
安装步骤
-
克隆此仓库：
git clone https://github.com/YOUR_USERNAME/alpaca-mcp.git cd alpaca-mcp -
安装所需的包：
pip install mcp alpaca-py python-dotenv -
创建一个
.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
- 打开 Claude for Desktop
- 转到设置
- 点击“开发者”，然后点击“编辑配置”
- 将服务器配置添加到
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
可用工具
服务器公开以下工具：
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 按市价成交”
- “卖出 10 股 TSLA，价格为 X”
- “取消所有未成交订单”
📚 详细文档
注意事项
- 此服务器需要有效的 Alpaca API 密钥才能正常运行。
- 建议在生产环境中使用此工具时仔细审查代码并确保安全性。
安全提示
始终审查通过此服务器发送的指令，以防止未经授权的交易或操作。