Trading API MCP

你可以做什么

• 账户与投资组合：查看余额、购买力、头寸、投资组合历史和账户活动
• 交易：下单和管理股票、期权和加密货币订单（市价单、限价单、止损单、追踪止损单、括号订单、多腿价差）
• 市场数据：查询历史和实时数据：K 线、报价、成交、快照、带希腊值的期权链
• 发现：筛选最活跃股票、市场异动、新闻、公司行动
• 组织：创建和管理自选列表

前提条件

• Python 3.10+（官方安装指南）
• uv 及 uvx（安装指南）
• Alpaca API key：免费的模拟交易账户即可入门
• MCP 客户端：Claude Desktop、Cursor、VS Code、Claude Code、Gemini CLI、PyCharm 或任何兼容 MCP 的工具

设置

使用你的 API key 将服务器添加到 MCP 客户端配置中。无需 init 命令或额外设置。

Cursor

添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

Claude 桌面版

添加到你的 Claude Desktop 配置（claude_desktop_config.json）中：

{
  "mcpServers": {
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

VS Code

添加到你的 VS Code 设置（.vscode/mcp.json）中：

{
  "servers": {
    "alpaca": {
      "command": "uvx",
      "args": ["alpaca-mcp-server"],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

Claude Code（CLI）

claude mcp add alpaca --scope user --transport stdio uvx alpaca-mcp-server \
  --env ALPACA_API_KEY=your_alpaca_api_key \
  --env ALPACA_SECRET_KEY=your_alpaca_secret_key

Docker

git clone https://github.com/alpacahq/alpaca-mcp-server.git
cd alpaca-mcp-server
docker build -t mcp/alpaca:latest .
docker run -e ALPACA_API_KEY=your_key -e ALPACA_SECRET_KEY=your_secret mcp/alpaca:latest

对于其他客户端（Gemini CLI、PyCharm、ChatGPT），请参阅 README 设置部分。

验证

重启你的 MCP 客户端，然后询问：

"我的 Alpaca 账户余额和购买力是多少？"

如果你收到了账户详情，则说明服务器已连接。

配置

所有配置均通过 MCP 客户端配置中的环境变量进行。

工具集筛选

使用 ALPACA_TOOLSETS 控制你的 AI 助手可用的工具。这对于限制范围（例如只读市场数据）或保持在 MCP 客户端工具限制内很有用。

示例 — 只读市场数据：

{
  "env": {
    "ALPACA_TOOLSETS": "account,stock-data,crypto-data,options-data,news"
  }
}

支持的 MCP 客户端

可用工具

Alpaca 的 MCP Server 在 Trading API 和 Market Data API 中提供 65 个工具。

账户与投资组合

订单

头寸

自选列表

资产与市场信息

股票数据

加密货币数据

期权数据

固定收益数据

公司行动与新闻

示例提示词

以下是一些连接后可以询问的内容：

账户与投资组合

• "我当前的账户余额和购买力是多少？"
• "显示我所有的未平仓头寸。"
• "我过去一个月的投资组合表现如何？"

交易

• "以市价买入 10 股 AAPL。"
• "下一笔限价单以 $350 卖出 50 股 TSLA。"
• "为我的 NVDA 头寸设置 5% 的追踪止损。"
• "取消我所有未成交订单。"

市场数据

• "显示 AAPL 上周的每日价格 K 线。"
• "BTC/USD 的最新报价是多少？"
• "获取 MSFT 的快照，包括最新成交和报价。"
• "当前最活跃的股票有哪些？"

期权

• "显示下个月到期的 AAPL 可用期权。"
• "这个 TSLA 300 看跌期权的希腊值是多少？"
• "在 SPY 上建立一个牛市看涨价差。"

自选列表

• "创建一个名为 Tech Earnings 的自选列表，包含 AAPL、MSFT、NVDA 和 GOOGL。"

提示： 使用模拟交易 API key 安全地测试策略。仅当你使用实盘 API key 设置 ALPACA_PAPER_TRADE=false 时才切换到实盘交易。

重要注意事项

• API key 安全：切勿将 API key 粘贴到聊天中。仅在你的 MCP 客户端的 env 块或操作系统密钥存储中配置它们。
• 订单执行：订单直接针对 Alpaca 的 Trading API 执行。在确认之前请审查 AI 建议的订单。
• 模拟与实盘：服务器默认使用模拟交易。使用实盘密钥设置 ALPACA_PAPER_TRADE=false 以用真实资金交易。
• 速率限制：Alpaca 的 API 对每个账户有限流。高频查询可能触发限流。
• 市场数据订阅：某些实时数据可能需要 Algo Trader Plus 订阅。

从 V1 升级

V2 并非 V1 的直接替代品。工具名称和参数已更改。如果你需要 V1，请固定使用较旧的 PyPI 版本：

{
  "args": ["alpaca-mcp-server==1.x.x", "serve"]
}

详情请参阅 README 中的从 V1 升级部分。

资源

• GitHub 仓库
• V2 发布博客文章
• Cursor Directory
• 贡献与开发（AGENTS.md）
• Alpaca 支持

免责声明

我们的 MCP server 及连接的 AI 代理生成的洞察仅供教育和信息目的，不应视为投资建议。模型的过往表现不保证未来结果。在做出任何决策之前，请自行进行尽职调查。