这个项目能做什么

Alpaca MCP Server是Alpaca交易与市场数据API的官方Model Context Protocol服务器。它允许兼容MCP的助手和IDE——包括Claude Desktop、Claude Code、Cursor、VS Code、PyCharm和Antigravity——发现Alpaca工具，并通过自然语言请求执行交易或研究任务。 版本2是使用FastMCP和OpenAPI构建的完全重写版本。它与v1不向后兼容：工具名称、参数、模式和配置均已更改，因此升级后的安装应重新配置、重启客户端并启动新会话。如有需要，V1可以继续固定使用最后一个1.x版本。 该服务器通过uvx在本地以stdio方式运行，也可以使用Docker构建和运行。配置通过MCP客户端配置中的环境变量提供：ALPACA_API_KEY和ALPACA_SECRET_KEY为必填项，ALPACA_PAPER_TRADE默认为true，ALPACA_TOOLSETS可用于限制暴露的能力。README警告不要将该服务器直接暴露到公共互联网，因为它本身不提供远程MCP身份验证。 暴露的能力按工具集组织，涵盖账户和投资组合信息、交易、持仓、自选列表、资产和市场状态、股票数据、加密货币数据、期权数据、公司行动、新闻、固定收益数据和卖空定位。具体操作包括查看余额和购买力、检索投资组合历史和账户活动、下达股票/ETF、加密货币和期权订单、替换或取消订单、查看或平仓、行使期权以及管理自选列表。 市场数据工具涵盖历史与最新K线、报价、成交、快照、订单簿、期权链、希腊值、隐含波动率、日历、时钟、公司行动公告、新闻和固定收益报价。该服务器还包括用于Alpaca指南和OpenAPI端点参考的文档查询工具。部分数据和定位能力取决于Alpaca订阅或实盘账户资格。 该项目记录了多个MCP客户端的设置、实盘交易配置、工具集过滤、示例提示，以及包含完整性检查、服务器构建测试、模拟API集成测试和文档集成测试的测试套件。