AI导哈

Alpaca MCP Server

Alpaca MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，允许像 Claude 这样的 LLMs 通过自然语言与 Alpaca 交易 API 进行交互。它支持股票交易、查看持仓、获取市场数据以及管理账户等功能。

  • by idsts2670
  • 更新于
在 GitHub 查看 idsts2670/mcp_server_Alpaca_Trading_API

使用说明

基本能力

产品定位

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 客户端

安装教程

  1. 克隆仓库:

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

  2. 安装依赖包:

    pip install mcp alpaca-py python-dotenv

  3. 创建 .env 文件并添加 Alpaca API 凭证:

    API_KEY_ID=your_alpaca_api_key
API_SECRET_KEY=your_alpaca_secret_key

调试方式

  1. 启动服务器:

    python alpaca_mcp_server.py

  2. 配置 Claude for Desktop:

    • 打开 Claude for Desktop
    • 进入设置
    • 点击 "Developer" 然后 "Edit Config"
    • 添加服务器配置到 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

相关 MCP