FindMCP Logo FindMCP.info
Alpaca MCP Server

Alpaca MCP Server

site icon
2025.03.24 0
Python股票交易金融API金融服务
Alpaca MCP Server 是一个基于 Model Context Protocol (MCP) 的服务，用于连接大型语言模型（如 Claude）与 Alpaca 交易 API。它允许用户通过自然语言进行股票交易、查看持仓、获取市场数据以及管理账户。
View on GitHub

Overview

基本能力

产品定位

Alpaca MCP Server 是一个金融交易服务，通过自然语言交互实现股票交易和账户管理。

核心功能

  • Alpaca 文档访问：提供 Alpaca SDK 文档支持
  • 市场数据：获取实时股票报价和历史价格数据
  • 账户信息：查看余额、购买力和账户状态
  • 持仓管理：查看当前持仓及其表现
  • 订单管理：通过自然语言下达市价单和限价单
  • 订单跟踪：列出、跟踪和取消订单

适用场景

  • 通过自然语言进行股票交易
  • 实时查看市场数据和账户信息
  • 管理投资组合和订单

工具列表

  • 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 密钥
  • Claude for Desktop 或其他 MCP 客户端

安装教程

  1. 克隆仓库： bash git clone https://github.com/YOUR_USERNAME/alpaca-mcp.git cd alpaca-mcp

  2. 安装依赖包： bash 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. 启动服务： bash python alpaca_mcp_server.py

  2. 配置 Claude for Desktop：

  3. 打开 Claude for Desktop
  4. 进入设置
  5. 点击"Developer"然后"Edit Config"
  6. 在 claude_desktop_config.json 中添加服务器配置
  7. 保存并重启 Claude for Desktop

许可证

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