alpaca-mcp-server

一个全面的 Model Context Protocol (MCP) 服务器，用于 Alpaca 的交易 API。通过 Claude、Cursor 和 VS Code 等 AI 助手实现自然语言交易操作。支持股票、期权、加密货币、投资组合管理和实时市场数据。

Alpaca MCP Server v2 来了。 此版本是使用 FastMCP 和 OpenAPI 构建的完全重写版本。如果你正在从 v1 升级，请阅读升级指南——工具名称、参数和配置均已更改。

目录

• 从 V1 升级
• 先决条件
• 获取 API 密钥
• 设置
• 配置
• 功能特性
• 示例提示
• 可用工具
• 测试
• 项目结构
• 故障排除
• 披露

---

从 V1 升级

V2 是使用 FastMCP 和 OpenAPI 构建的完全重写版本。V2 中不存在任何 V1 工具——工具名称、参数和 schema 均已更改。如果你的设置依赖于特定的 V1 工具名称或参数，则不能将 V2 作为直接替代品。

变更内容

| 方面 | V1 | V2 | | --- | --- | --- | | 工具名称 | 手工编写（例如 get_account_info） | 由规范派生并带有覆盖（例如 get_account_info — 名称可能重叠，但 schema 不同） | | 参数 | 自定义 schema | 与 Alpaca API 规范对齐 | | 配置 | .env + init 命令 | 仅通过 MCP 客户端配置中的环境变量 | | 工具过滤 | 不支持 | ALPACA_TOOLSETS 环境变量 | | 白名单 | 不支持 | 使用 ALPACA_TOOLSETS 限制工具 |

如何避免在 V2 中使用 V1 风格

MCP 客户端会从服务器动态发现工具。不存在一个你可以“白名单”工具名称的配置文件——客户端会获取服务器暴露的所有工具。为避免你的客户端或 AI 助手错误地使用 V2：

1. 不要复用 V1 配置 — 将 V2 视为一个新服务器。使用新的命令/参数更新你的 MCP 客户端配置；移除任何基于 .env 或 init 的设置。
2. 清除工具缓存 — 切换后重启你的 MCP 客户端（Claude Desktop、Cursor、VS Code 等），以便它获取新的工具列表，而不是使用过时的列表。
3. 开启新的聊天/会话 — 现有对话可能缓存了对旧工具名称的引用。开启新聊天，让 LLM 看到当前的 V2 工具及其 schema。
4. 更新自定义指令和规则 — 如果你的 Cursor 规则、Claude 指令或其他提示中提到了特定的 V1 工具名称（例如“使用 get_account_info”），请更新它们以匹配 V2 工具名称，或删除这些引用，让 LLM 从上下文中发现工具。
5. 使用 ALPACA_TOOLSETS 限制工具 — 如果你之前限制了助手可用的功能，V2 支持通过 ALPACA_TOOLSETS 环境变量进行服务端过滤。有关工具集列表，请参阅配置 > 工具集过滤。

总结

假设 **…