← 返回目录

Alpaca MCP Server

官方

Alpaca官方MCP服务器，让您通过自然语言直接交易股票、ETF、加密货币和期权。

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 95 / 438
Stars: ★ 1.0k 非常热门
传输方式: stdio（本地进程）
运行环境: Python 3.10+ · Docker
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 16 天前
工具数: 74

62FMRS · C

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

最强项 · 文档质量 16/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

12/20

维护活跃度

10/20

文档质量

16/20

安装易用性

14/20

查看各项评分依据

可靠性 10/20: 仓库与 manifest 提供了 v2.2.0 版本和完整的工具清单，README 声称有 integrity、server-construction、paper API、ReadMe 测试及 CI，但所给材料中只有 README 和 manifest，没有实际 CI 工作流或测试文件，无法从静态证据验证启动握手与工具行为。按静态校准，缺少可执行证据时可靠性最高不超过 12，因此保守给 10 分。扣分主要来自缺少可核验的测试证据和可诊断的失败路径。
安全与权限 12/20: 密钥通过 ALPACA_API_KEY 与 ALPACA_SECRET_KEY 注入并在 manifest 中标记为 secret；默认使用 paper trading，HTTP 传输默认监听 localhost，数据收集仅披露 user agent，安装示例使用占位符而非真实令牌，并可用 ALPACA_TOOLSETS 收缩工具范围，未触发红线。但服务器暴露 close_all_positions、cancel_all_orders、exercise_options_position 等高风险工具，没有内建的确认步骤，权限与确认机制不完整，因此给 12 分。
维护活跃度 10/20: 项目有 MIT 许可证、未归档，存在 v2 重写、2.2.0 版本和 v1→v2 升级指南，说明处于维护状态且有发布路径。但所给材料中没有提交历史、issue 响应、依赖更新记录或安全响应渠道的证据，26 个 open issues 也无法判断处理情况，保守给 10 分。
文档质量 16/20: README 覆盖了前置条件、多客户端安装、认证、环境变量表、toolset 过滤、特性、大量示例提示词、可用工具、测试命令、排障、披露、隐私与安全说明，并明确说明 15 分钟数据需订阅、Broker API 文档不在范围内等限制。扣分点为缺少逐工具参数级文档、API 限流与成本细节，因此给 16 分。
安装易用性 14/20: README 提供了 uvx 命令以及 Claude Desktop、Cursor、VS Code、Claude Code、PyCharm、Antigravity、Docker 等客户端的配置示例，环境变量集中，步骤清晰。扣分点在于依赖 uv/uvx，且无法从静态材料验证 PyPI 包确实可发布和运行；静态校准限制 setup 最高 15，故保守给 14 分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

安装接入

准备工作

运行环境：Python 3.10+ · Docker

ALPACA_API_KEY 必填密钥必填的 Alpaca Trading API 密钥，需在 app.alpaca.markets 注册（可先用免费 paper trading 账户）后在 Dashboard 生成。

ALPACA_SECRET_KEY 必填密钥必填的 Alpaca API 私钥，与 API Key 一起在 Alpaca Dashboard 生成，属敏感凭据。

其他可选配置项（2 个）

ALPACA_PAPER_TRADE 可选可选，默认 true（纸面交易），设为 false 才会启用实盘交易。

ALPACA_TOOLSETS 可选可选，逗号分隔的工具集列表（如 stock-data,crypto-data），用于限制启用的工具，默认全部启用。

确保安装Python 3.10+和uv。
在Alpaca Dashboard创建免费纸面交易账户并生成API密钥。
根据你使用的MCP客户端（如Claude Desktop、Cursor、VS Code）编辑配置文件，添加上述mcpServers配置，填入你的API密钥。
重启客户端。

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"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "alpaca": {
      "command": "uvx",
      "args": [
        "alpaca-mcp-server"
      ],
      "env": {
        "ALPACA_API_KEY": "your_alpaca_api_key",
        "ALPACA_SECRET_KEY": "your_alpaca_secret_key"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add alpaca -e ALPACA_API_KEY=your_alpaca_api_key -e ALPACA_SECRET_KEY=your_alpaca_secret_key -- uvx alpaca-mcp-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

将服务器添加到 MCP 客户端配置并重启后，检查工具列表中是否出现 get_account_info 等工具，然后询问 "What's my current account balance on Alpaca?"，若能返回账户余额即说明连接成功。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

我在 Alpaca 账户里现在有多少购买力？
以市价买入 5 股 AAPL。
给我看 AAPL 最近 5 个交易日的日线历史行情。
取消我所有未成交的股票订单。

工具能力 74

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获取单个订单

展开其余 66 个工具

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端点的参考文档

使用场景

查询账户余额和购买力

查看当前持仓和订单状态

通过自然语言下达股票、加密货币和期权订单

获取实时和历史市场数据（K线、报价、成交）

管理自选列表和公司行为公告

支持客户端

Claude Desktop

Cursor

VS Code

Claude Code

PyCharm

Antigravity CLI

ChatGPT部分支持

Claude Mobile部分支持

依据项目文档列出，未经本站实测。

详细介绍

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