🚀 Alpaca MCP 服务器
Alpaca MCP 服务器是专为 Alpaca 设计的模型上下文协议（MCP）服务器。它能让像 Claude 这样的大语言模型（LLLM）通过对接 Alpaca 交易 API 实现交互。借助该服务器，用户可以通过自然语言完成股票交易、查看持仓、获取市场数据以及管理账户等操作，极大地提升了交易的便捷性和效率。
✨ 主要特性
- 📚 Alpaca 文档访问：可访问 Alpaca SDK 文档，便于开发者进行开发工作。
- 📊 市场数据：能够获取实时股票报价和历史价格数据，为投资决策提供有力支持。
- 💵 账户信息：方便查看账户余额、购买力和账户状态，让用户随时掌握账户情况。
- 📈 持仓管理：可以查看当前持仓及其表现情况，帮助用户及时调整投资策略。
- 🛒 订单下单：支持通过自然语言放置市价单和限价单，操作简单便捷。
- 📋 订单管理：能够列出、跟踪并取消订单，有效管理交易流程。
📦 安装指南
先决条件
- 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 - 创建包含 Alpaca API 凭证的
.env文件：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，您可以提出以下问题：
- 查看我的账户余额。
- 列出当前所有持仓。
- 获取 Apple 股票的实时报价。
- 下达买入 Google 股票的市价单。
📚 详细文档
注意事项
⚠️ 重要提示
默认情况下，服务器使用模拟交易环境。如需切换至真实交易，请参考相关文档。
💡 使用建议
请谨慎处理 API 凭证信息，确保账户安全。
📄 许可证
``` （由于原文档此处许可证内容为空，所以保留原样）