Alpaca Trading

🚀 Alpaca MCP 服务器

Alpaca MCP 服务器是专为 Alpaca 设计的模型上下文协议（MCP）服务器。它能让像 Claude 这样的大语言模型（LLLM）通过对接 Alpaca 交易 API 实现交互。借助该服务器，用户可以通过自然语言完成股票交易、查看持仓、获取市场数据以及管理账户等操作，极大地提升了交易的便捷性和效率。

✨ 主要特性

• 📚 Alpaca 文档访问：可访问 Alpaca SDK 文档，便于开发者进行开发工作。
• 📊 市场数据：能够获取实时股票报价和历史价格数据，为投资决策提供有力支持。
• 💵 账户信息：方便查看账户余额、购买力和账户状态，让用户随时掌握账户情况。
• 📈 持仓管理：可以查看当前持仓及其表现情况，帮助用户及时调整投资策略。
• 🛒 订单下单：支持通过自然语言放置市价单和限价单，操作简单便捷。
• 📋 订单管理：能够列出、跟踪并取消订单，有效管理交易流程。

📦 安装指南

先决条件

• Python 3.10 或更高版本
• Alpaca API 凭证
• Claude for Desktop 或其他 MCP 客户端

安装步骤

1. 克隆此仓库：

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

2. 安装所需包：

   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
   

💻 使用示例

运行服务器

通过运行以下命令启动服务器：

python alpaca_mcp_server.py

配置 Claude for Desktop

1. 打开 Claude for Desktop。
2. 转到设置。
3. 点击“开发者”，然后点击“编辑配置”。
4. 将服务器配置添加到 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"
      }
    }
  }
}

5. 保存并重新启动 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 凭证信息，确保账户安全。

📄 许可证

``` （由于原文档此处许可证内容为空，所以保留原样）