Robinhood Portfolio Tracker MCP

Robinhood投资组合追踪器（命令行界面）

这个项目为Robinhood提供了一个命令行投资组合追踪器，支持登录、查看投资组合以及进行基本交易。它还包括一个模拟交易模式，用于安全测试。

重要提示：真实货币交易存在风险。请先使用模拟模式。您需对您的账户及遵守监管规定负责。

特点/特性

• 使用用户名/密码或设备令牌（带会话缓存）登录
• 查看投资组合持仓、现金、绩效概览
• 下达市场买卖订单（计划支持限价功能）
• 带有本地状态文件的模拟交易模式
• 简单的动量策略示例及再平衡指令

快速入门

1. 创建并激活虚拟环境

python3 -m venv .venv && source .venv/bin/activate

1. 安装依赖项

pip install -r requirements.txt

1. 设置环境变量

export RH_USERNAME="your_email@example.com"
export RH_PASSWORD="your_password"
export RH_DEVICE_TOKEN="your_device_token_optional"
export RH_PAPER="true"  # set to "false" to enable live trading
# Optional: if you already have an access token from the web app
export RH_ACCESS_TOKEN="paste_access_token_here"
export RH_TOKEN_TYPE="Bearer"

1. 运行命令行界面（CLI）

python -m robinhood_tracker --help

命令

• login验证并缓存会话
• portfolio显示位置、股权和现金
• buy --symbol AAPL --quantity 1市价买入
• sell --symbol AAPL --quantity 1市场出售
• rebalance --symbols AAPL,MSFT,GOOGL --allocations 40,30,30示例策略

交易机器人命令

• bot add --symbol AAPL --quantity 10 --stop-loss -5.0 --take-profit 10.0添加位置以进行监控
• bot remove --symbol AAPL从监控中移除位置
• bot start --interval 5启动机器人（每5分钟检查一次）
• bot stop停止机器人
• bot status显示监控的仓位和当前盈亏情况
• bot check手动检查所有位置一次

MCP（模型上下文协议）集成

该项目包括一个全面的MCP适配器，用于人工智能模型的集成。

可用工具

MCP适配器提供了15种交易和投资组合管理工具：

投资组合管理

• get_portfolio - 获取投资组合概览和持仓情况
• get_health - 检查API服务器状态
• login - 使用Robinhood进行身份验证

交易操作

• buy_stock - 以指定代码和数量购买股票
• sell_stock - 出售指定代码和数量的股票
• rebalance_portfolio - 自动调整以达到目标配置比例

交易机器人管理

• get_bot_status - 获取机器人状态和监控中的仓位
• add_bot_position - 添加带有止损/止盈的位置
• remove_bot_position - 从监控中移除位置
• start_bot - 启动自动化交易机器人
• stop_bot - 停止自动化交易机器人
• check_bot_positions - 手动检查所有位置

期权交易

• get_options_positions - 获取当前期权持仓
• get_options_orders - 获取最新的期权订单
• get_options_instruments - 获取符号的可用选项

使用示例

# List all available tools
python3 mcp_robinhood_adapter.py --list-tools

# Get portfolio
python3 mcp_robinhood_adapter.py --tool get_portfolio

# Buy stock
python3 mcp_robinhood_adapter.py --tool buy_stock --params '{"symbol": "AAPL", "quantity": 1}'

# Add position to bot
python3 mcp_robinhood_adapter.py --tool add_bot_position --params '{"symbol": "AAPL", "quantity": 1, "stop_loss": 5, "take_profit": 10}'

人工智能模型集成

配置您的AI模型以使用MCP服务器：

{
  "mcpServers": {
    "robinhood": {
      "command": "python3",
      "args": ["/path/to/robinhood_tracker/mcp_robinhood_adapter.py"]
    }
  }
}

安全注意事项

• 永远不要提交凭证。使用环境变量或 .env 文件未被 Git 跟踪。
• 纸张模式将本地状态写入 .paper_state.json。
• MCP服务器通过本地HTTP API（127.0.0.1:5000）与Python后端进行通信。

免责声明

这不是财务建议。使用后果自负。