Alpaca

mcp-alpaca

Alpaca MCP — 通过 Alpaca Market Data API 获取实时美国股市数据

属于 Pipeworx — 一个 MCP 网关，可将 AI Agent 连接到 1679+ 个实时数据源。

工具

工具	描述
alpaca_snapshot	美国股票实时快照，覆盖盘前和盘后时段：最新成交价、买卖报价、今日 OHLCV、前收盘价、相对于前收盘价的涨跌额和涨跌幅，以及最新的一分钟 K 线及其 VWAP — 在盘前和盘后时段，一分钟 K 线价格即为实时盘前／盘后价格。可回答“OKTA 的盘前价格”“隔夜涨跌幅”“盘后成交量和最高价／最低价”等问题。多个代码以逗号分隔（最多 20 个）。使用自带 Alpaca API 密钥（BYOK，免费账户），实时 IEX 行情源。示例：alpaca_snapshot({ symbols: "OKTA,AAPL", _apiKey: "key_id:secret_key" })
alpaca_bars	美国股票历史 OHLCV K 线，包含每根 K 线的 VWAP 和成交笔数。时间周期：1Min/5Min/15Min/1Hour/1Day；IEX 行情源的日内 K 线包含盘前和盘后时段。每根 K 线包含：{t, o, h, l, c, v, vwap, trades}。使用 ISO 时间戳指定开始／结束时间，或使用“2h”“5d”等回溯时长简写。多个代码以逗号分隔（最多 20 个）。使用自带 Alpaca API 密钥（BYOK，免费账户）。示例：alpaca_bars({ symbols: "AAPL", timeframe: "5Min", lookback: "1d", _apiKey: "key_id:secret_key" })
alpaca_intraday_vwap	美国股票当前交易时段的 VWAP — 当前价格高于还是低于 VWAP？获取今日从 04:00 ET 开始的一分钟 K 线（包含盘前时段），计算累积成交量加权平均价，并与最新成交价进行比较。按代码返回 current_price、session_vwap、above_vwap 和交易时段成交量。一次调用即可回答“BLK、AAPL、RHI、CTAS 当前的 VWAP 是多少，高于还是低于 VWAP？”多个代码以逗号分隔（最多 20 个）。使用自带 Alpaca API 密钥（BYOK，免费账户），实时 IEX 行情源。示例：alpaca_intraday_vwap({ symbols: "BLK,AAPL,RHI,CTAS", _apiKey: "key_id:secret_key" })

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "alpaca": {
      "url": "https://gateway.pipeworx.io/alpaca/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/alpaca/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 的共享元工具 — ask_pipeworx、 discover_tools、search_within、remember/recall，以及网关范围内的其他工具。因此，你看到的工具数量会多于此表所列数量：目前，单个工具包端点除了列出该工具包自身的工具外，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，并且是当天范围的权威说明。

这是有意为之，并非意外的多路复用。元工具可让受限连接通过 ask_pipeworx（它会在整个目录中路由），回答此工具包无法处理的问题，而无需添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义带来的上下文开销大于路由功能的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者连接完整的 Pipeworx 网关，直接获取每个工具包列出的所有工具，而不仅是当前工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1679+ 个数据源。唯一的区别在于直接列出哪些工具包的工具；通过任一端点，ask_pipeworx 都可以访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

此工具包需要你提供自己的 API 密钥（_apiKey）——我们不会代为提供，因此这里没有无需密钥即可运行的 curl 示例。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/alpaca_snapshot。查找工具：使用 {"query":"..."} 向 POST https://gateway.pipeworx.io/v1/tools/search_packs 发送请求。

独立运行（无需 gateway 账号）

此软件包也可作为本地 stdio MCP 服务运行，无需 Pipeworx 账号，也无需经过网关往返：

{
  "mcpServers": {
    "alpaca": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-alpaca"]
    }
  }
}

或者直接运行，确认它可以启动：

npx -y @pipeworx/mcp-alpaca

它通过 stdin/stdout 使用 MCP 通信，并响应 initialize/tools/list/tools/call，仅提供此软件包中的工具，不包含上方网关连接额外提供的任何共享元工具。使用相同的源代码和工具，无需 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗的英语提问，而不是直接调用工具——这既适用于上方的软件包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Alpaca data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT