Robin Stocks MCP

罗宾汉工具

提供CLI和MCP访问的monorepo 罗宾股票 （非官方）Robinhood API。

包裹

快速开始

命令行界面

# Clone and install globally
git clone https://github.com/ach968/robinhood-tools.git
cd robinhood-tools
uv tool install ./robinhood-cli

# Login (prompts for username/password)
rh login

# Use
rh price AAPL MSFT
rh quote TSLA
rh portfolio
rh positions
rh options-chain SPY --expiry 2026-06-20 --type call
rh history AAPL --interval day --span month
rh orders --type stock --since 2026-01-01
rh watchlists
rh news NVDA
rh fundamentals AMD
rh status
rh logout

所有命令支持 --json 用于原始JSON输出。

MCP 服务器

添加到您的OpenCode配置(~/.config/opencode/opencode.json):

{
  "mcp": {
    "robinhood": {
      "type": "local",
      "command": [
        "uvx",
        "--from", "git+https://github.com/ach968/robinhood-tools.git",
        "robinhood-mcp",
        "--username", "your_username",
        "--password", "your_password"
      ],
      "enabled": true
    }
  }
}

看 罗宾汉mcp/README.md 获取完整的MCP文档。

发展

# Clone
git clone https://github.com/ach968/robinhood-tools.git
cd robinhood-tools

# Install all packages
cd robinhood-core && uv pip install -e ".[dev]"
cd ../robinhood-cli && uv pip install -e ".[dev]"
cd ../robinhood-mcp && uv pip install -e ".[dev]"

# Run tests
cd robinhood-core && uv run pytest tests/ -v
cd ../robinhood-cli && uv run pytest tests/ -v
cd ../robinhood-mcp && uv run pytest tests/ -v

CLI命令

所有命令接受 --json 用于机器可读输出。

MCP工具

建筑

robinhood-core/           # Shared library
├── robinhood_core/
│   ├── client.py         # RobinhoodClient (robin-stocks wrapper)
│   ├── errors.py         # Exception types
│   ├── models/           # Pydantic models
│   └── services/         # Business logic services

robinhood-cli/            # CLI tool
├── robinhood_cli/
│   ├── main.py           # Typer app entry point
│   ├── auth.py           # Session management
│   ├── output.py         # Rich formatting helpers
│   └── commands/         # Command modules

robinhood-mcp/            # MCP server
├── robin_stocks_mcp/
│   └── server.py         # MCP tool implementations

安全须知

• 所有工具都是 只读 --无法下订单或修改帐户
• CLI将会话令牌存储在 ~/.config/robinhood/ （pickle文件+配置）
• MCP通过CLI参数或环境变量接受凭据
• 密码和令牌从不记录

Pi代理技能

要使用它，请复制到您的pi技能目录：

mkdir -p ~/.pi/agent/skills/rh-cli
cp skills/rh-cli.md ~/.pi/agent/skills/rh-cli/SKILL.md

安装后，pi会自动建议使用 rh 当您询问Robinhood数据时，可以使用命令。

免责声明

此项目使用 罗宾股票，一个非官方的Python库。它不隶属于Robinhood Markets，股份有限公司或由其背书。使用风险自负。

许可证

麻省理工学院