Robinhood Portfolio MCP Server

关键词

Robinhood投资组合分析股票数据接口LLM 集成JSON-RPC

使用说明（Markdown 格式）

  • 项目简介

    • 该仓库实现了一个基于 FastMCP 的 MCP 服务器，用于提供 Robinhood 投资组合数据的只读访问，同时暴露一组只读工具函数，供 LLM 客户端通过 MCP 协议调用。服务器包含会话管理、登录状态检测以及对 robin_stocks 的封装调用，确保对外暴露的接口是可预测且只读的。
    • 核心能力包括：向客户端提供组合信息、持仓、行情、新闻、分红、选项仓位等数据的只读访问，以及对相关数据的分析性工具调用入口。

  • 主要功能点（易懂描述）

    • 数据访问工具（只读）：
      • robinhood_get_portfolio：获取投资组合总价值等数据
      • robinhood_get_positions：获取当前持仓明细
      • robinhood_get_watchlist、robinhood_get_quote、robinhood_get_fundamentals、robinhood_get_historicals、robinhood_get_news、robinhood_get_earnings、robinhood_get_ratings、robinhood_get_dividends、robinhood_get_options_positions、robinhood_search_symbols
    • 会话与认证管理：
      • 自动登录、验证登陆状态、缓存会话，提供只读访问前提下的稳健会话处理
    • MCP 兼容性与输出：
      • 通过 FastMCP 暴露工具为 MCP 客户端（如 LLM 客户端）提供统一的 JSON-RPC 风格请求/响应能力
    • 安全与环境隔离：
      • 封装 robin_stocks 调用，所有外部通信都在服务端执行，避免直接暴露凭据

  • 安装步骤（简明易操作）

    • 克隆仓库并安装依赖：
      • 使用常规安装方式：pip 安装并进入开发模式
      • 安装时可执行测试与 lint，确保代码质量
    • 安装并运行服务：
      • 使用官方脚本启动：robinhood-mcp
      • 或使用 uvx 启动方式：uvx robinhood-mcp
    • 配置 Robinhood 登录信息（本地环境变量）
      • ROBINHOOD_USERNAME：Robinhood 用户名
      • ROBINHOOD_PASSWORD：Robinhood 密码
      • ROBINHOOD_TOTP_SECRET（可选）：用于基于 TOTP 的两步验证
    • 运行后，请确保服务日志显示已登录状态以确保后续请求可用

  • 服务器配置（给 MCP 客户端的连接信息） 说明：MCP 客户端需要提供服务器的启动命令及参数，以便建立连接。以下为符合该仓库信息的示例配置要点（以 JSON 形式给出，便于直接粘贴到客户端配置中）： { "server_name": "robinhood", "command": "uvx", "args": ["robinhood-mcp"], "env": { "ROBINHOOD_USERNAME": "你的 Robinhood 用户名", "ROBINHOOD_PASSWORD": "你的 Robinhood 密码", "ROBINHOOD_TOTP_SECRET": "可选的 TOTP 秘钥（如使用两步验证）" }, "notes": "确保环境变量中的凭据在服务器启动前可用，服务器启动后将暴露只读的 Robinhood 数据与工具接口给 MCP 客户端。" }

  • 基本使用方法

    • 启动后使用 MCP 客户端与服务器建立连接
    • 通过客户端发起 JSON-RPC 风格的请求，调用 robinhood_get_portfolio、robinhood_get_positions 等工具
    • LLM 客户端可结合这些数据进行对话、分析与生成研究报告
    • 如需要更改配置（如凭据、环境变量），请在服务器启动前完善环境配置

服务器信息

访问项目