alpaca-mcp 是一个 Model Context Protocol（MCP）服务器，为 Alpaca 交易 API 提供接口，使用户能够管理股票和加密货币投资组合、下单交易并访问市场数据。
用途方面，该服务器旨在将 Alpaca 的交易能力通过 MCP 协议暴露给兼容的客户端（如 Claude for Desktop），方便用户在对话或自动化流程中查询账户、执行交易和管理持仓。
主要能力包括：
- 账户管理：查看账户详情、余额和投资组合状态。
- 交易：下达市价单、限价单、止损单和止损限价单。
- 投资组合管理：查看持仓、计算表现并平仓。
- 市场数据：获取实时报价和历史价格数据。
- 资产信息：获取可交易资产的详细信息。
使用方式上，用户可以通过 Smithery 将 Alpaca Trading MCP Server 自动安装到 Claude Desktop，或者手动安装：克隆该仓库、安装依赖、将 .env.example 复制为 .env 并填入 Alpaca Paper Trading API 凭据（需在 Alpaca 创建账户获取），然后运行 MCP 服务器。服务器启动后即可供 MCP 客户端连接。若要与 Claude for Desktop 测试，需编辑其配置文件（Windows 路径为 %APPDATA%\Claude\claude_desktop_config.json，Mac 路径为 ~/Library/Application Support/Claude/claude_desktop_config.json），并添加 Alpaca MCP 服务器配置。
该服务器提供的资源包括：
- account://info：获取当前账户信息
- positions://all：获取所有当前持仓
- positions://{symbol}：获取特定符号的持仓详情
- orders://recent/{limit}：获取指定数量的最近订单
- market://{symbol}/quote：获取特定符号的当前市场报价
- market://{symbol}/bars/{timeframe}：获取特定符号指定时间框架的历史价格柱
- assets://list：列出 Alpaca 上可交易的资产
- assets://{symbol}：按符号获取详细的资产信息
提供的工具包括：
- get_account_info_tool：获取当前账户信息
- place_market_order：下达买入或卖出股票的市价单
- place_limit_order：以指定价格下达买入或卖出股票的限价单
- place_stop_order：当股票达到指定价格时下达买入或卖出的止损单
- place_stop_limit_order：结合止损单和限价单功能的止损限价单
- cancel_order：按 ID 取消未成交订单
- close_position：平掉特定符号的未平仓头寸
- get_portfolio_summary：获取投资组合的综合摘要
适用场景包括需要通过 MCP 客户端进行股票和加密货币投资组合查询、交易下单和市场数据获取的用户，尤其是使用 Alpaca Paper Trading 进行模拟交易的场景。
限制方面，该服务器依赖 Alpaca API 凭据，且手动安装需自行配置环境；官方资料未提供其他功能、收费、价格、平台或效果的详细信息。
