Alpaca Trading MCP Server

Alpaca Trading MCP Server

site icon
2025.04.24 0
Python金融交易自动化量化交易金融服务
Alpaca Trading MCP Server 是一个基于 Python 实现的 Model Context Protocol (MCP) 服务器,专为 Alpaca 交易平台设计。它允许大型语言模型(如 Anthropic Claude)与 Alpaca 的交易 API 进行交互,提供账户管理、市场数据访问、交易操作和持仓跟踪等功能。该服务主要用于金融交易自动化,支持模拟交易(Paper Trading)以确保安全性。
View on GitHub

Overview

基本能力

产品定位

Alpaca Trading MCP Server 是一个连接大型语言模型与 Alpaca 交易平台的中间件,旨在通过标准化协议(MCP)实现金融交易的自动化。

核心功能

  • 账户管理:查看账户信息和投资组合摘要
  • 市场数据:获取实时报价和历史价格数据
  • 交易操作:下达市价单和限价单
  • 持仓跟踪:监控当前持仓和近期订单

适用场景

  • 金融交易自动化
  • 量化交易策略开发
  • 教育与研究用途的模拟交易

工具列表

  • place_market_order(symbol, side, qty) - 下达市价单
  • place_limit_order(symbol, side, qty, limit_price) - 下达限价单
  • cancel_order(order_id) - 取消订单
  • get_portfolio_summary() - 获取投资组合摘要

常见问题解答

  • 安全性:默认使用模拟交易(ALPACA_PAPER=TRUE),避免真实资金风险
  • 数据限制:实时市场数据功能可能需要 Live 交易账户
  • 路径配置:需在 Claude for Desktop 配置文件中正确指定绝对路径

使用教程

使用依赖

  1. 安装 uv(Python 包管理器): bash curl -LsSf https://astral.sh/uv/install.sh | sh

安装教程

  1. 克隆仓库: bash git clone https://github.com/MardiantoS/alpaca-mcp-server.git cd alpaca-mcp-server
  2. 创建虚拟环境(推荐): bash uv venv source .venv/bin/activate
  3. 安装依赖: bash uv sync
  4. 配置 .env 文件: ALPACA_API_KEY=your_api_key ALPACA_API_SECRET=your_api_secret ALPACA_PAPER=TRUE

调试方式

  1. 在 Claude for Desktop 的开发者配置中添加服务器路径
  2. 重启 Claude 后尝试以下查询:
  3. "What's my current Alpaca portfolio balance?"
  4. "Place a buy limit order for 10 shares of JPMorgan Chase at $238."
  5. "Buy 1 share of GOOGL at market price."

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。