如何在 Claude 移动应用上远程部署 Alpaca 的 MCP 服务器
Source: Dev.to
概览
Alpaca 官方 MCP 服务器 的推出,使大型语言模型(LLM)客户端——如 Cursor、ChatGPT 和 Claude——能够通过自然语言或代码研究、分析和下单。
本指南展示了如何将 Model Context Protocol (MCP) server 连接到 Claude Mobile App,提供透明的执行流程,并提供可选的“免代码”路径,后续可扩展为完整的自动化。
前置条件
| 工具 | 详情 |
|---|---|
| Alpaca API 密钥 | 纸面或实时交易访问(可选)。参见《如何获取 Alpaca 的交易 API 密钥并开始连接》或《如何使用 Alpaca 开始纸面交易》。 |
| Python | 版本 3.10+ |
| Docker | Docker Hub 账户 |
| GitHub | 用于克隆仓库的账户 |
| uv | 通过官方指南安装 |
| AI 工具(MCP 客户端) | 建议付费订阅(示例使用 Claude Pro) |
| 终端 | macOS/Linux 或 命令提示符 / PowerShell(Windows) |
| 云服务 | AWS、Azure、GCP、Render 等(示例使用 Render) |
您可以做什么
- 检索 Alpaca 账户详情、投资组合持仓、未实现 P&L、市场数据以及公司新闻。
- 使用 AI 辅助推理分析市场趋势、收益要点和价格波动。
- 在单一、连贯的工作流中构建和完善交易算法。
- 通过 AI 驱动的 CLI(例如 Claude Code、Gemini CLI)自动化重复性任务。
- 通过自然语言或使用 Alpaca 的 Trading API 以编程方式下单。
快速设置流程
- 在本地安装 Alpaca 的 MCP 服务器 并构建 Docker 镜像。
- 部署 Docker 镜像 到云服务(本指南中使用 Render)。
- 将远程 MCP 服务器 连接到 Claude AI(网页和移动端)。
每个步骤的详细说明如下。
1️⃣ 安装并容器化 MCP 服务器
# Clone the repo
git clone https://github.com/alpacahq/alpaca-mcp-server.git
cd alpaca-mcp-server
验证 Docker 安装
docker version
docker info
登录 Docker Hub
docker login
# Prompted for Docker Hub username & password
构建并推送镜像
将 username 和 custom-docker-image-name 替换为你的 Docker Hub 用户名和想要的镜像名称。
docker buildx build \
--pull \
--platform=linux/amd64 \
-t username/custom-docker-image-name:v1.0.1 \
. \
--push
如果你愿意,也可以使用 latest 标签代替 v1.0.1。
本地健康检查
docker run --rm -p 8000:8000 \
-e PORT=8000 \
username/custom-docker-image-name:latest \
python -m alpaca_mcp_server.server \
--transport streamable-http \
--host 0.0.0.0 \
--port 8000
你应该会看到类似以下的输出:
INFO: Started server process [1]
INFO: Waiting for application startup.
StreamableHTTP session manager started
INFO: Application startup complete.
INFO: Uvicorn running on http://0.0.0.0:8000 (Press CTRL+C to quit)
2️⃣ 将镜像部署到云服务(Render)
您可以使用任何能够运行 Docker 容器的云平台;以下步骤以 Render 为例。
-
在 Render 的仪表盘上 创建一个新项目。
-
点击 “Create new service” → “Web Service”。
-
选择 “Existing Images” 并粘贴 Docker 镜像地址,例如:
docker.io/username/custom-docker-image-name:latest -
选择实例规格(本教程可使用免费层)。
-
为 MCP 服务器 添加环境变量:
变量 值 ALPACA_API_KEY您的 Alpaca API 密钥 ALPACA_SECRET_KEY您的 Alpaca secret 密钥 -
在 Advanced Settings 中,将 Docker Command 设置为启动服务器的命令:
alpaca-mcp-server serve \ --transport streamable-http \ --host 0.0.0.0 \ --port $PORT -
点击 “Deploy Web Service”。
部署完成后,Render 将显示类似以下的日志和 URL:
https://alpaca-mcp-server-v1-0-3latest.onrender.com
3️⃣ 将远程 MCP 服务器连接到 Claude
添加自定义连接器(Claude Web)
-
打开 Claude 网页界面。
-
前往 Manage Connectors → Add Custom Connector。
-
填写:
-
Connector name:
Alpaca’s MCP Server(或任意你喜欢的名称) -
Remote MCP Server URL:
https://alpaca-mcp-server-v1-0-3latest.onrender.com/mcp
确保 URL 以
/mcp结尾。 -
-
保存。此时你应该能在列表中看到该连接器状态为 connected。
在 Claude Mobile 上验证
- 打开 Claude mobile app。
- 在聊天界面,点击消息框旁的 plus (+) 图标。
- 向下滚动并选择 Manage Connectors。
- 确认 Alpaca’s MCP Server 已出现并处于启用状态。
现在,你可以发出自然语言指令(例如 “显示我的投资组合”、 “买入 10 股 AAPL”),Claude 将通过远程 MCP 服务器将指令路由到 Alpaca 的交易 API。
🎉 您已准备就绪!
您拥有:
- Containerized Alpaca 的 MCP Server。
- Deployed 它作为远程服务。
- Integrated 它与 Claude(web & mobile)。
从这里,您可以开始构建 AI 驱动的交易工作流、自动化重复任务,或尝试完全程序化的策略——全部通过自然语言或代码。祝您交易愉快!
在 Claude 移动应用中使用 Alpaca 的 MCP 服务器入门
-
定位连接器
- 在 Claude 移动应用中打开 Connectors 列表。
- 在 Custom Connectors 下找到 Alpaca’s MCP Server。
- 点击它以 enable 并开始使用。
-
确认连接
- 验证 Alpaca 的 MCP 服务器已连接到 Claude 应用。
- 现在您可以通过 Alpaca Trading API 利用 AI 驱动的交易。
远程 MCP 服务器的安全注意事项
公开运行 MCP 服务器会带来若干安全风险:
- 未认证访问 – 许多早期示例(例如 FastMCP)是为本地测试构建的,缺乏身份验证或加密。
- 凭证泄露 – 如果服务器存储 Alpaca API 密钥,任何能够访问该端点的人都可能滥用这些密钥。
推荐的防护措施
| 问题 | 缓解措施 |
|---|---|
| 明文流量 | 部署 HTTPS/TLS 以加密所有通信。 |
| 未认证请求 | 实现 基于令牌的身份验证(例如 JWT、API 密钥)。 |
| 网络开放暴露 | 使用防火墙或 VPN 限制入站流量,并在可能的情况下使用 IP 白名单。 |
采取这些措施可保护您的凭证,并确保只有受信任的客户端能够与您的 MCP 服务器交互。
立即尝试
- 探索 GitHub 仓库,获取可直接运行的 MCP 服务器实现。
- 注册 Alpaca 账户(如果尚未注册),并开始模拟交易。
有用资源
- Alpaca‑py SDK 文档 – Python SDK 的综合指南。
- 注册 Alpaca 交易 API 账户 – Alpaca 注册
- 如何连接到 Alpaca 的交易 API – 步骤详尽的连接教程。
- 如何使用 Alpaca 的交易 API 开始模拟交易 – 学习无风险测试策略。
- 使用 Claude 和 Google 表格构建基于 MCP 的交易工作流 – 自动化示例。
- Vibe Coding:使用 Alpaca 的 MCP 服务器和 Cursor AI 构建期权交易算法 – 视频演示。
- API 参考文档:关于交易 API – 完整的端点参考。
其他媒体
- Alpaca的MCP服务器YouTube播放列表 – 精选视频,涵盖设置、安全性和高级用例。
提示: 在我们的 forum、Slack community 或 subreddit 分享您的经验、问题和反馈。您的见解有助于提升整个生态系统,惠及所有对使用 Alpaca’s Trading API 进行算法交易感兴趣的人。