Alpaca's Official MCP Server

Alpaca Trading API 的综合性模型上下文协议（MCP）服务。通过 Claude、Cursor 和 VS Code 等 AI 助手启用自然语言交易操作。支持股票、期权、加密货币、投资组合管理和实时市场数据。

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

目录

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

---

从 V1 升级

V2 使用 FastMCP 和 OpenAPI 完全重写。V1 的工具在 V2 中均不存在——工具名称、参数和架构均已更改。如果你的设置依赖特定的 V1 工具名称或参数，则无法将 V2 直接替换为 V1。

变更内容

方面	V1	V2
工具名称	手工编写（例如 get_account_info）	根据规范生成并支持覆盖（例如 get_account_info——名称可能相同，但架构不同）
参数	自定义架构	与 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. 开始新的聊天/会话——现有对话可能缓存了旧工具名称的引用。开始新聊天，以便大模型获取当前 V2 工具及其架构。
4. 更新自定义指令和规则——如果你有提及特定 V1 工具名称（例如“使用 get_account_info”）的 Cursor 规则、Claude 指令或其他提示词，请更新为 V2 工具名称，或移除这些引用，让大模型根据上下文发现工具。
5. 使用 ALPACA_TOOLSETS 限制工具——如果你之前限制了助手可使用的功能，V2 支持通过 ALPACA_TOOLSETS 环境变量在服务端进行筛选。有关工具集列表，请参阅配置 > 工具集筛选。

总结

请假定 V1 不具备向后兼容性。为 V2 重新配置 MCP 客户端、重启客户端，并使用新的会话。请查看可用工具部分，了解当前工具列表。

如果你有自定义 V1 工作流

如果你记录了允许使用的工具、编写了按名称调用工具的脚本，或基于特定 V1 工具/参数结构编写了提示词，请将它们视为已过时。请使用下方列出的可用工具以及服务端公开的当前参数架构重新创建。

继续使用 V1

如果你需要继续使用 V1，请在 MCP 客户端配置中锁定到最后一个 V1 版本（例如 uvx alpaca-mcp-server==1.x.x serve）。现有配置仍可从 PyPI 获取 V1。

---

前置条件

• Python 3.10+（安装指南）
• uv（安装指南）
• Alpaca Trading API 密钥（免费模拟交易账户）
• MCP 客户端（Claude Desktop、Cursor、VS Code 等）

获取 API 密钥

1. 访问 Alpaca Dashboard
2. 创建免费的模拟交易账户
3. 在控制面板中生成 API 密钥

设置

将服务端添加到 MCP 客户端配置，然后重启客户端。无需 init 命令，也无需 .env 文件——凭据只需在一个位置设置。

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（Mac）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）：

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

Claude Mobile

Claude Mobile 需要远程 MCP 服务。此软件包不会配置远程 MCP 身份验证，因此请勿使用你的 Alpaca API 密钥将其直接暴露到公共互联网。请在受支持的桌面客户端中使用本地 stdio 设置。

ChatGPT

ChatGPT 需要远程 MCP 服务。此软件包不会配置远程 MCP 身份验证，因此请勿使用你的 Alpaca API 密钥将其直接暴露到公共互联网。请在受支持的桌面客户端中使用本地 stdio 设置。

Cursor

只需点击几下，即可从 Cursor Directory 安装；也可以将以下内容添加到 ~/.cursor/mcp.json：

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

VS Code

在项目根目录中创建 .vscode/mcp.json。请参阅官方文档。

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

PyCharm

请参阅官方指南。

1. 前往 File → Settings → Tools → Model Context Protocol (MCP)
2. 添加新服务：

• 类型：stdio
• 命令：uvx
• 参数：alpaca-mcp-server

3. 设置环境变量：

 ALPACA_API_KEY=your_alpaca_api_key
 ALPACA_SECRET_KEY=your_alpaca_secret_key

Claude Code

claude mcp add alpaca --scope user --transport stdio uvx alpaca-mcp-server \
  --env ALPACA_API_KEY=your_alpaca_api_key \
  --env ALPACA_SECRET_KEY=your_alpaca_secret_key

在 Claude Code CLI 中使用 /mcp 验证。

Antigravity CLI

请参阅 Antigravity MCP 文档。

添加到 ~/.gemini/antigravity-cli/mcp_config.json（全局）或 .agents/mcp_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"
      }
    }
  }
}

Docker

git clone https://github.com/alpacahq/alpaca-mcp-server.git
cd alpaca-mcp-server
docker build -t mcp/alpaca:latest .

添加到 MCP 客户端配置：

{
  "mcpServers": {
    "alpaca": {
      "command": "docker",
      "args": [
        "run", "--rm", "-i",
        "-e", "ALPACA_API_KEY=your_key",
        "-e", "ALPACA_SECRET_KEY=your_secret",
        "-e", "ALPACA_PAPER_TRADE=true",
        "mcp/alpaca:latest"
      ]
    }
  }
}

配置

所有配置都通过 MCP 客户端配置中的环境变量完成。不会将任何文件写入磁盘。

变量	必需	默认值	描述
ALPACA_API_KEY	是	—	你的 Alpaca API 密钥
ALPACA_SECRET_KEY	是	—	你的 Alpaca 密钥
ALPACA_PAPER_TRADE	否	true	设置为 false 以进行实盘交易
ALPACA_TOOLSETS	否	all	以逗号分隔的待启用工具集列表

切换到实盘交易

更新 MCP 客户端配置中的 env 块并重启：

{
  "env": {
    "ALPACA_API_KEY": "your_live_api_key",
    "ALPACA_SECRET_KEY": "your_live_secret_key",
    "ALPACA_PAPER_TRADE": "false"
  }
}

工具集筛选

默认情况下，所有工具均已启用。若要将服务限制为特定工具集，请设置 ALPACA_TOOLSETS：

{
  "env": {
    "ALPACA_API_KEY": "...",
    "ALPACA_SECRET_KEY": "...",
    "ALPACA_TOOLSETS": "stock-data,crypto-data"
  }
}

可用工具集：

工具集	描述
account	账户信息、配置、投资组合历史记录、活动
trading	订单、持仓、行权期权
watchlists	自选列表 CRUD 操作
assets	资产查询、期权合约、日历、时钟
stock-data	股票 K 线、报价、成交记录、快照、筛选器
crypto-data	加密货币 K 线、报价、成交记录、快照、订单簿
options-data	期权 K 线、报价、成交记录、快照、期权链、交易所代码
corporate-actions	公司行动公告
news	股票和加密货币新闻文章
fixed-income-data	固定收益（债券／国债）报价
locates	卖空定位请求和报价

ReadMe Docs MCP

文档范围涵盖 Trading API、Market Data API 和 Authentication API 规范；此服务有意排除 Broker API 端点文档。

如果 ReadMe MCP 查询失败，工具响应中会提供指向 Alpaca 公开文档以及 llms.txt 和 llms-full.txt 的备用链接。

功能

• 市场数据 — 获取股票、加密货币和期权的实时报价、成交和价格柱。支持灵活时间范围的历史数据，以及期权希腊值和隐含波动率。
• 账户管理 — 查看余额、购买力、账户状态和投资组合历史记录。
• 订单管理 — 为股票、加密货币和期权下达市价单、限价单、止损单、止损限价单和追踪止损单。可单独或批量取消订单。
• 期权交易 — 按到期日／行权价／类型搜索合约。下达单腿或多腿策略。获取最新报价、希腊值和隐含波动率。
• 加密货币交易 — 使用 GTC／IOC 下达市价单、限价单和止损限价单。支持按数量或名义金额下单。
• 持仓管理 — 查看、平仓或清仓持仓。行使期权合约。
• 新闻 — 可按代码和日期范围筛选新闻文章。
• 市场状态 — 查看市场开市／收市时间、日历和公司行动。
• 自选列表 — 创建、更新和管理自选列表。
• 资产搜索 — 通过筛选查询股票、ETF、加密货币和期权的详情。

示例提示词

基础交易

1. 我在 Alpaca 的当前账户余额和购买力是多少？
2. 显示我 Alpaca 账户中的当前持仓。
3. 按市价买入 5 股 AAPL。
4. 以 300 美元的限价卖出 5 股 TSLA。
5. 取消所有未成交的股票订单。
6. 取消 ID 为 abc123 的订单。
7. 清仓我持有的全部 GOOGL。
8. 平掉我 NVDA 持仓的 10%。
9. 下达限价单，以 450 美元买入 100 股 MSFT。
10. 下达市价单，卖出 25 股 META。

加密货币交易

1. 下达市价单，买入 0.01 ETH/USD。
2. 下达限价单，以 110,000 美元卖出 0.01 BTC/USD。

期权交易

1. 显示下个月到期的 AAPL 可用期权合约。
2. 获取 AAPL250613C00200000 期权的最新报价。
3. 获取 SPY250627P00400000 期权的快照。
4. 清仓我持有的 2 份下周到期的 QQQ 看涨期权合约。
5. 下达市价单，买入 1 份下周五到期的 AAPL 看涨期权。
6. TSLA250620P00500000 期权的希腊值是多少？
7. 查找行权价在当前市价上下 5% 范围内的 TSLA 期权合约。
8. 获取 2025 年 6 月 16 日当周到期、价格在市价上下 10% 范围内的 SPY 看涨期权。
9. 使用 6 月 6 日到期的 AAPL 期权构建看涨价差：一份行权价为 190.00，另一份行权价为 200.00。
10. 行使我的 NVDA 看涨期权合约 NVDA250919C001680。

市场信息

如需获取最新的 15 分钟数据，你需要订阅 Algo Trader Plus Plan。

1. 今天市场的开盘和收盘时间是什么？
2. 显示下周的市场日历。
3. 显示过去 3 个月 AAPL、MSFT 和 GOOGL 的近期现金股息和股票拆分。
4. 获取过去一年 SPY 的所有公司行动，包括股息、拆分和任何合并事项。
5. 未来 6 个月 SPY 计划进行哪些公司行动？

历史数据与实时数据

1. 显示 AAPL 过去 5 个交易日的每日价格历史。
2. TSLA 昨天的收盘价是多少？
3. 获取 GOOGL 的最新 K 线。
4. NVDA 的最新成交价是多少？
5. 显示 MSFT 的最新报价。
6. 获取 AMD 最近的 100 笔交易。
7. 显示 AMZN 过去 2 小时的 1 分钟 K 线。
8. 获取从上周二到上周五的 TSLA 5 分钟日内 K 线。
9. 获取 AAPL 的综合股票快照，在一个视图中显示最新报价、成交、分钟 K 线、每日 K 线和前一日 K 线。
10. 对比 TSLA、NVDA 和 MSFT 的市场快照，分析它们当前的买卖价差、最新成交价和每日表现。

订单

1. 显示我本周所有未成交和已成交的订单。
2. 我有哪些 AAPL 订单？
3. 列出我过去 3 天下达的所有限价单。
4. 按状态筛选所有订单：已成交。
5. 获取我昨天的订单历史。

自选列表

目前，你只能通过 API 查看和更新使用 Alpaca 的 Trading API 创建的交易自选列表。

1. 创建一个名为“Tech Stocks”的自选列表，包含 AAPL、MSFT 和 NVDA。
2. 更新我的“Tech Stocks”自选列表，加入 TSLA 和 AMZN。
3. 我的“Dividend Picks”自选列表中有哪些股票？
4. 从我的“Growth Portfolio”自选列表中移除 META。
5. 列出我所有现有的自选列表。

资产信息

1. 搜索资产“AAPL”的详细信息。
2. 显示按交易量排名前 5 的可交易加密资产。
3. 获取所有 NASDAQ 活跃的美国股票资产，并筛选结果，仅显示可交易证券。

组合场景

1. 获取今天的市场时钟，并在下达 340 美元买入 TSLA 的限价单之前显示我的购买力。
2. 使用 7 月 3 日到期的 SPY 期权构建看涨价差：卖出一份行权价高于当前 SPY 价格 5% 的期权，并买入一份行权价低于当前 SPY 价格 3% 的期权。

可用工具

账户与投资组合

• 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 柱
• get_stock_quotes — 历史买卖报价
• get_stock_trades — 历史成交
• get_stock_latest_bar — 最新分钟柱
• get_stock_latest_quote — 最新报价
• get_stock_latest_trade — 最新成交
• get_stock_snapshot — 综合快照
• get_most_active_stocks — 按成交量/成交笔数获取最活跃股票
• get_market_movers — 涨幅和跌幅最大的股票

加密货币数据

• get_crypto_bars — 历史 OHLCV 柱
• get_crypto_quotes — 历史报价
• get_crypto_trades — 历史成交
• get_crypto_latest_bar — 最新分钟柱
• get_crypto_latest_quote — 最新报价
• get_crypto_latest_trade — 最新成交
• get_crypto_snapshot — 综合快照
• get_crypto_latest_orderbook — 最新订单簿

期权数据

• get_option_bars — 历史 OHLCV 柱
• 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_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 端点的参考文档

测试

项目包含一个多层测试套件，会在每次拉取请求时于 CI 中运行：

• 完整性测试 — 验证 OpenAPI 规范、工具集定义以及工具名称和描述覆盖项之间的一致性。无需网络或凭据。
• 服务构建测试 — 使用模拟凭据构建服务，并验证公开的工具数量是否正确。无需网络。
• 模拟 API 集成测试 — 对 Alpaca 模拟交易 API 执行真实调用，涵盖账户信息、市场数据、订单生命周期、关注列表、持仓等。需要 ALPACA_API_KEY 和 ALPACA_SECRET_KEY。
• ReadMe 集成测试 — 对 Alpaca 的 ReadMe MCP 执行实时文档查询调用。在本地运行时需要设置 ALPACA_RUN_README_INTEGRATION=true。

在本地运行完整测试套件：

# Core tests (no credentials needed)
pytest tests/test_integrity.py tests/test_server_construction.py -v

# Integration tests (requires paper API keys)
ALPACA_API_KEY=... ALPACA_SECRET_KEY=... pytest tests/ -m integration -v

# ReadMe docs integration tests (requires network, no Alpaca credentials)
ALPACA_RUN_README_INTEGRATION=true pytest tests/test_readme_integration.py -v

项目结构

alpaca-mcp-server/
├── src/
│   └── alpaca_mcp_server/
│       ├── __init__.py
│       ├── cli.py            ← CLI entry point
│       ├── server.py         ← FastMCP server built from OpenAPI specs
│       ├── tool_registry.py  ← Tool names, descriptions, and output risk classifications
│       ├── toolsets.py       ← Toolset → operationId allowlists
│       ├── overrides.py      ← Hand-crafted tools for complex trading endpoints
│       ├── market_data_overrides.py ← Hand-crafted tools for historical data
│       ├── readme_docs.py    ← Read-only proxy tools for Alpaca ReadMe docs
│       └── specs/
│           ├── trading-api.json
│           └── market-data-api.json
├── tests/
│   ├── conftest.py           ← Shared fixtures and paper-account cleanup
│   ├── test_integrity.py     ← Spec ↔ toolset ↔ names consistency checks
│   ├── test_server_construction.py ← Server build verification
│   ├── test_readme_integration.py ← Live ReadMe docs MCP integration tests
│   └── test_paper_integration.py   ← Paper API integration tests
├── scripts/
│   └── sync-specs.sh        ← Download latest OpenAPI specs
├── .github/
│   └── workflows/
│       ├── ci.yml            ← CI pipeline (core + integration)
│       └── publish-pypi.yml  ← PyPI publish on GitHub Release
├── AGENTS.md                 ← Instructions for coding agents
├── pyproject.toml
└── README.md

故障排除

• 找不到 uv/uvx：按照官方指南（https://docs.astral.sh/uv/getting-started/installation/）安装 uv，然后重启终端，以便将 uv/uvx 添加到 PATH。
• 缺少凭据：在客户端的 env 块中设置 ALPACA_API_KEY 和 ALPACA_SECRET_KEY。模拟模式默认值为 ALPACA_PAPER_TRADE = True。
• 客户端未加载新配置：更改后重启客户端（Cursor、Claude Desktop、VS Code）。
• HTTP 端口冲突：如果使用 --transport streamable-http，请将 --port 更改为一个空闲端口。

声明

我们的 MCP 服务及其连接的 AI Agent 生成的见解仅供教育和信息参考，不应视为投资建议。Alpaca 不推荐任何特定证券或投资策略。请在做出任何决定前自行尽职调查。所有提及的公司均独立运营，彼此不承担责任。

由于期权交易本身风险较高，可能导致重大损失，因此并不适合所有投资者。投资期权前，请阅读《标准化期权的特征与风险》（期权披露文件）。

Alpaca 不编制、编辑、认可或批准第三方内容。Alpaca 不保证第三方内容的准确性、及时性、完整性或实用性，也不对第三方网站上的或其提供的任何内容、广告、产品或其他材料承担责任。

所有投资均有风险，证券或金融产品的过往表现不保证未来结果或回报。不能保证任何投资策略都能实现其目标。请注意，分散投资并不能确保盈利，也不能防止损失。投资证券或其他金融产品始终存在亏损的可能。投资者应在投资前仔细考虑自己的投资目标和风险。 该算法的计算基于历史和实时市场数据，但可能未考虑所有市场因素，包括价格突然波动、流动性限制或执行延迟。模型假设（例如波动率估算和股息处理方式）可能会影响性能和准确性。算法生成的交易受券商执行流程、市场流动性、订单优先级和时间延迟的影响。这些因素可能导致实际交易执行价格或时间偏离预期。用户有责任监控算法活动并了解相关风险。Alpaca 不对使用本系统造成的任何损失负责。

过去的假设回测结果不保证未来收益，实际结果可能与分析有所不同。

Paper Trading API 由 AlpacaDB, Inc. 提供，不要求使用真实资金，也不允许用户在市场中交易真实证券。提供 Paper Trading API 的使用权限，并不构成购买或出售任何种类证券、证券衍生品或期货产品的要约或招揽，也不构成任何类型的交易或投资建议、推荐或策略；AlpacaDB, Inc. 或其任何关联公司均未以任何方式认可这些内容。通过 Paper Trading API 提供的信息，在 AlpacaDB, Inc. 或其任何关联公司（统称为“Alpaca”）未经授权开展业务的任何司法管辖区内，均不构成任何形式的要约或招揽。

证券经纪服务由 Alpaca Securities LLC（“Alpaca Securities”）提供，该公司是 FINRA/SIPC 成员，也是 AlpacaDB, Inc. 的全资子公司。技术和服务由 AlpacaDB, Inc. 提供。

加密货币服务由 Alpaca Crypto LLC（“Alpaca Crypto”）提供，该公司是在 FinCEN 注册的货币服务业务机构（NMLS # 2160858），也是 AlpacaDB, Inc. 的全资子公司。Alpaca Crypto 不是 SIPC 或 FINRA 的成员。加密货币不是股票，您的加密货币投资不受 FDIC 或 SIPC 保护。加密货币资产波动性和投机性极高，涉及重大损失风险，且不受 FDIC 或任何政府机构承保。客户在使用这些服务前，应了解各种风险，包括本金可能损失、网络安全因素、监管动态以及数字资产技术不断演进的特性。有关加密货币风险的更多信息，请点击此处。

在 Alpaca Securities 或 Alpaca Crypto（视情况而定）未注册或未获许可的任何司法管辖区内，本内容均不构成购买或出售证券或加密货币、开设经纪账户或加密货币账户的要约、要约招揽或建议。

隐私政策

有关 Alpaca 如何处理您的数据，请参阅：

• 隐私政策
• 披露资料库

数据收集

• 收集内容：API 调用的用户代理字符串（APCA-MCP-TRADING/<version>）
• 使用方式：用于识别 MCP 服务的使用情况并改善用户体验
• 第三方共享：不会与第三方共享
• 保留期限：按照 Alpaca 的标准数据保留政策保留
• 选择退出：将 ALPACA_MCP_USER_AGENT 环境变量设为空字符串；不会发送 User-Agent 标头

安全提示

此服务可以执行真实交易并访问您的投资组合。请将 API 密钥视为敏感凭据。仔细检查 LLM 提出的所有操作，尤其是复杂的期权策略或多腿交易。

HTTP 传输安全性：Streamable HTTP 默认绑定到 localhost（127.0.0.1:8000），并验证 Host 和 Origin 标头。Docker 默认使用 stdio。Helm 默认使用关闭 ingress 的 ClusterIP HTTP。绑定到 0.0.0.0 并不提供身份验证。此软件包未配置 MCP OAuth，因此请勿将其直接暴露到公共互联网。提供基于标准的 MCP 身份验证的运维人员还必须将 FastMCP 的 FASTMCP_HTTP_ALLOWED_HOSTS 设置为确切的公共主机名。

支持

如有问题或疑问，请通过 [email protected] 联系我们。

GitHub 问题：https://github.com/alpacahq/alpaca-mcp-server/issues GitHub 拉取请求：https://github.com/alpacahq/alpaca-mcp-server/pulls

MCP 注册表元数据

mcp-name: io.github.alpacahq/alpaca-mcp-server