AI导哈

Alpaca交易协议服务器

Alpaca MCP服务器是一个模型上下文协议服务器，允许LLMs（如Claude）通过自然语言与Alpaca交易API交互，实现股票交易、持仓查询、市场数据获取和账户管理。

  • by tedlikeskix
  • Python
  • 本地部署
  • 28 星标
  • 更新于
在 GitHub 查看 tedlikeskix/alpaca-mcp-server

使用说明

羊驼MCP服务器

这是Alpaca的模型上下文协议（MCP）服务器，允许Claude等LLM与Alpaca交易API进行交互。它可以通过自然语言进行股票交易、查看头寸、获取市场数据和管理账户。

特性

  • 📊 市场数据 -获取实时股票报价和历史价格数据
  • 💵 账户信息 -检查您的余额、购买力和状态
  • 📈 职位管理 -查看当前职位及其绩效
  • 🛒 下订单 -通过自然语言下达市价单和限价单
  • 📋 订单管理 -列出、跟踪和取消订单

先决条件

  • Python 3.10+
  • Alpaca API钥匙
  • Claude用于桌面或其他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

用法

运行服务器

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

python alpaca_mcp_server.py

为桌面配置Claude

  1. 打开Claude桌面版
  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"
      }
    }
  }
}
  1. 保存并重新启动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股”
  • “以130美元的限价出售10股AMZN”
  • “取消我所有的未结订单”

备注

此服务器默认使用Alpaca的纸质交易。要使用真钱交易，请更改 paper=True 向 paper=False 在 TradingClient 初始化。

安全通知

此MCP服务器将可以访问您的羊驼账户，并可以进行真实交易。在批准任何交易之前，一定要审查克劳德的建议。

许可证

麻省理工学院

相关 MCP