← 返回目录
A

Alpaca MCP Server

官方
Alpaca官方MCP服务器,让您通过自然语言直接交易股票、ETF、加密货币和期权。
GitHub 源仓库 ↗
★ 926 Stars 分类 · 开发工具 非常热门 源版本 872abbf28dab
62FMRS · C
可靠性
10/20
安全与权限
12/20
维护活跃度
10/20
文档质量
16/20
安装易用性
14/20

Alpaca MCP服务器是Alpaca官方提供的,功能全面,覆盖多种资产类别和交易操作,但需要用户谨慎使用,因为涉及真实交易风险。

查看 FMRS 评分方法 →

Alpaca的官方MCP服务器,基于FastMCP和OpenAPI规范构建,提供60多种工具,覆盖账户管理、交易、持仓、市场数据、新闻等。支持股票、期权、加密货币、固定收益、指数等多种资产类别。用户可通过自然语言指令在AI助手(如Claude、Cursor、VS Code)中执行交易操作,获取实时和历史市场数据,管理投资组合。

工具能力

get_account_info
获取账户余额、保证金和账户状态
get_account_config
查看交易限制、保证金设置、PDT检查等账户配置
update_account_config
更新账户配置设置
get_portfolio_history
获取随时间变化的权益和盈亏历史
get_account_activities
获取成交、分红、转账等活动记录
get_account_activities_by_type
按类型筛选账户活动
get_orders
按筛选条件检索订单
get_order_by_id
按ID获取单个订单
get_order_by_client_id
按客户端订单ID获取单个订单
replace_order_by_id
替换现有未成交订单
cancel_order_by_id
取消特定订单
cancel_all_orders
取消所有未成交订单
place_stock_order
下达股票/ETF订单(市价、限价、止损等)
place_crypto_order
下达加密货币订单(市价、限价、止损限价)
place_option_order
下达期权订单(单腿或多腿)
get_all_positions
获取所有当前持仓
get_open_position
获取特定持仓详情
close_position
关闭特定持仓
close_all_positions
清仓整个投资组合
exercise_options_position
行权持有的期权合约
do_not_exercise_options_position
发送不行权指令
create_watchlist
创建新自选列表
get_watchlists
列出所有自选列表
get_watchlist_by_id
获取特定自选列表
update_watchlist_by_id
更新自选列表
delete_watchlist_by_id
删除自选列表
add_asset_to_watchlist_by_id
向自选列表添加资产
remove_asset_from_watchlist_by_id
从自选列表移除资产
get_all_assets
列出资产,可选择性过滤
get_asset
获取特定资产的详细信息
get_option_contracts
获取底层证券的期权合约
get_option_contract
按代码或ID获取单个期权合约
get_calendar
获取日期范围的市场日历
get_clock
获取当前市场状态和下次开盘/收盘时间
get_corporate_action_announcements
获取公司行为公告
get_corporate_action_announcement
按ID获取单个公告
get_stock_bars
获取历史OHLCV K线
get_stock_quotes
获取历史买卖报价
get_stock_trades
获取历史交易
get_stock_latest_bar
获取最新分钟K线
get_stock_latest_quote
获取最新报价
get_stock_latest_trade
获取最新成交
get_stock_snapshot
获取综合快照(报价、成交、分钟K线等)
get_most_active_stocks
按成交量或交易次数获取最活跃股票
get_market_movers
获取涨幅榜和跌幅榜
get_crypto_bars
获取加密货币历史K线
get_crypto_quotes
获取加密货币历史报价
get_crypto_trades
获取加密货币历史交易
get_crypto_latest_bar
获取加密货币最新分钟K线
get_crypto_latest_quote
获取加密货币最新报价
get_crypto_latest_trade
获取加密货币最新成交
get_crypto_snapshot
获取加密货币综合快照
get_crypto_latest_orderbook
获取加密货币最新订单簿
get_option_bars
获取期权历史K线
get_option_trades
获取期权历史交易
get_option_latest_trade
获取期权最新成交
get_option_latest_quote
获取期权最新报价(含买卖价和交易所)
get_option_snapshot
获取期权快照(含希腊字母和隐含波动率)
get_option_chain
获取底层证券的完整期权链
get_option_exchange_codes
获取交易所代码到名称的映射
get_corporate_actions
从市场数据获取公司行为公告
get_news
获取股票和加密货币的新闻文章
get_fixed_income_latest_quotes
按ISIN获取固定收益证券的最新报价
get_index_latest_values
获取市场指数的最新值
get_index_values
获取市场指数的历史值
get_locates
按状态、代码或日期范围列出借券请求
create_locate
为卖空创建借券请求
get_locate
按ID获取单个借券请求
get_locate_quotes
获取借券可用性和定价
search_alpaca_docs
搜索Alpaca文档页面和指南
fetch_alpaca_doc
按页面ID获取一个Alpaca ReadMe文档页面
search_alpaca_api_specs
按主题、路径、参数或模式搜索Alpaca API参考端点
list_alpaca_api_endpoints
列出一个允许的Alpaca OpenAPI规范的所有端点
get_alpaca_endpoint_docs
按方法和路径获取一个Alpaca API端点的参考文档

安装接入

  1. 确保安装Python 3.10+和uv。2. 在Alpaca Dashboard创建免费纸面交易账户并生成API密钥。3. 根据你使用的MCP客户端(如Claude Desktop、Cursor、VS Code)编辑配置文件,添加上述mcpServers配置,填入你的API密钥。4. 重启客户端。
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"
      }
    }
  }
}

选型与风险

适合谁

  • 需要自动化交易的开发者
  • 使用AI助手进行投资研究和交易执行的用户
  • 对Alpaca经纪服务熟悉的交易者

不适合谁

  • 需要托管远程MCP服务器的用户(Alpaca不提供托管服务)
  • 想要交易共同基金或期货的用户(服务器不支持)
  • 需要查看经纪商API文档的用户(服务器排除了经纪商API)

所需权限

  • 访问Alpaca账户信息(余额、持仓、订单)
  • 代表用户下达订单(买入、卖出、取消)
  • 读取市场数据和新闻
  • 读取Alpaca文档

风险与副作用

  • 服务器可以实际执行交易,可能导致资金损失
  • API密钥是敏感信息,需妥善保管
  • 期权和加密货币交易风险高,不适合所有投资者
  • 算法基于历史数据,可能无法预测未来市场

常见排障

  1. 如果uvx未找到,请安装uv并重启终端
  2. 确保在客户端配置中设置了ALPACA_API_KEY和ALPACA_SECRET_KEY
  3. 修改配置后重启客户端
  4. 如果使用HTTP传输,注意端口冲突

使用场景

查询账户余额和购买力
查看当前持仓和订单状态
通过自然语言下达股票、加密货币和期权订单
获取实时和历史市场数据(K线、报价、成交)
管理自选列表和公司行为公告

支持客户端

Claude Desktop完整支持
Cursor完整支持
VS Code完整支持
Claude Code完整支持
PyCharm完整支持
Antigravity CLI完整支持
ChatGPT部分支持
Claude Mobile部分支持