Robinhood MCP 服务器

这是一个模型上下文协议（MCP）服务器，提供给像 Claude Desktop 这样的大型语言模型（LLM）客户端使用 Robinhood 的交易功能。

概述

此 MCP 服务器公开了 Robinhood 的交易 API，作为一组可以被 Claude 或其他 LLM 客户端使用的工具和资源。它允许您：

• 查询股票报价和市场数据
• 下单购买各种类型的股票订单（市价单、限价单）
• 监控您的投资组合和仓位
• 跟踪未完成的订单和交易历史

设置

先决条件

• Python 3.8+
• uv 包管理器（推荐用于 Claude Desktop 集成）
• 一个 Robinhood 账户

安装

1. 克隆这个仓库：

git clone https://github.com/syyunn/rb-mcp.git
cd rb-mcp

2. 安装依赖项：

pip install fastmcp robin_stocks pydantic

3. 在 Claude Desktop 中安装服务器：

fastmcp install server.py

或者在开发模式下运行：

fastmcp dev server.py

使用

认证

在使用交易功能之前，您必须通过 Robinhood 进行认证：

要使用 Robinhood 的交易功能，请先登录。

[使用您的 Robinhood 凭据调用登录工具]

工具

该服务器提供了以下工具：

认证

• login - 通过 Robinhood 进行认证
• logout - 结束您的 Robinhood 会话

股票信息

• get_stock_quote - 获取股票的详细报价
• get_latest_price - 获取股票的当前价格

交易操作

• buy_stock_market_order - 下单购买市价单
• sell_stock_market_order - 下单卖出市价单
• buy_stock_limit_order - 下单购买限价单
• sell_stock_limit_order - 下单卖出限价单
• cancel_order - 取消未完成的订单

投资组合信息

• get_portfolio - 获取投资组合概览和账户余额
• get_positions - 查看所有当前的股票仓位
• get_open_orders - 查看所有未完成的订单

资源

该服务器还提供了这些资源：

• robinhood://stocks/{ticker}/info - 股票的详细信息
• robinhood://portfolio/summary - 投资组合概览
• robinhood://account/history/{timespan} - 指定时间段内的账户历史

示例对话

获取股票报价

用户：苹果股票的当前价格是多少？

Claude：让我为您查询苹果股票的当前价格。

[Claude 调用 get_stock_quote，参数 ticker="AAPL"]

苹果 (AAPL) 的当前价格是 $182.25。
买入价: $182.24
卖出价: $182.26
成交量: 23,451,872

下单购买

用户：我想购买 5 股微软。

Claude：我可以帮助您下单购买微软股票。

[Claude 调用 get_latest_price，参数 ticker="MSFT"]

微软 (MSFT) 当前的交易价格是每股 $417.82。

您想要以当前价格（大约 $2,089.10 总计）下单购买 5 股的市价单，还是希望设置一个特定价格的限价单？

用户：我们来做个市价单吧。

Claude：我将为您下单购买 5 股微软 (MSFT) 的市价单。

[Claude 调用 buy_stock_market_order，参数 ticker="MSFT"，数量=5]

您的市价单已成功下单！
订单ID: 12345abc-6789-def0-1234-56789abcdef0
状态: 排队中

安全注意事项

• 此工具需要您的 Robinhood 登录凭据
• 凭据不会存储在 MCP 服务器本身
• 认证令牌由 robin_stocks 库在一个本地的 pickle 文件中管理
• 在确认任何交易之前，请始终验证内容

许可证

本项目使用 Apache 2.0 许可证。

免责声明

此工具与 Robinhood 无关，也未得到 Robinhood 的认可。自行承担风险使用。股票交易涉及财务损失的风险。