Open Stocks MCP 翻译为中文是：“公开股票 MCP（或：市场中心平台/市场控制面板，具体根据上下文确定 MCP 的含义）”。不过，通常“MCP”在金融或股票领域可能没有一个固定的、广泛认可的中文翻译，它可能是一个特定公司、平台或系统的缩写。因此，在没有具体上下文的情况下，我们只能将其直译为“MCP”，并根据需要在实际应用中给出更具体的解释或翻译。如果“MCP”在此处有特定的含义或是一个知名平台的名称，那么应该根据该特定含义或名称进行翻译
一个MCP（模型上下文协议）服务器，通过多个经纪商API提供访问股市数据和交易功能。
特点/特性
🚀 当前状态：v0.7.0-dev - 支持多个经纪商（Robinhood + Schwab）
- ✅ 104套MCP工具 总计 - 80个Robinhood账户 + 24个Schwab账户（其中4个已弃用）
- ✅ 多经纪人架构 - 支持Robinhood和Charles Schwab
- ✅ 完整的交易功能 - 股票、期权、订单管理
- ✅ 实时交易已验证 - Robinhood股票和期权交易已通过真实订单测试
- ✅ 已准备好投入生产 - HTTP传输，Docker支持，全面测试
- ✅ 施瓦布（Schwab）集成完成 - OAuth 认证，24 个工具已准备就绪进行测试
- 🔧（扳手，常用于表示修理、工具等意思） 账户详情已确定 - 真实的财务数据，而非“不适用”值
安装
pip install open-stocks-mcp用于开发：
git clone https://github.com/Open-Agent-Tools/open-stocks-mcp.git
cd open-stocks-mcp
uv pip install -e .快速入门
1. 设置凭据
创建一个 .env 文件：
对于Robinhood：
ROBINHOOD_USERNAME=your_email@example.com
ROBINHOOD_PASSWORD=your_password对于施瓦布（可选）：
SCHWAB_API_KEY=your_api_key
SCHWAB_APP_SECRET=your_app_secret
SCHWAB_CALLBACK_URL=https://127.0.0.1:8182/
SCHWAB_TOKEN_PATH=~/.tokens/schwab_token.json
# Enable both brokers
ENABLED_BROKERS=robinhood,schwab注： 施瓦布要求开发者账号和API审批（需数天）。参见 docs/SCHWAB_INTEGRATION_PLAN.md 详情如下。
2. 启动服务器
HTTP传输（推荐）
open-stocks-mcp-server --transport http --port 3001STDIO 传输
open-stocks-mcp-server --transport stdio3. 测试服务器
# Health check (HTTP transport)
curl http://localhost:3001/health
# Interactive testing
uv run mcp dev src/open_stocks_mcp/server/app.pyDocker 部署
生产环境Docker设置：
cd examples/open-stocks-mcp-docker
docker-compose up -d特点：
- 持久会话存储
- 自动日志轮转
- 健康监测
- 安全头部和跨域资源共享（CORS）
MCP客户端集成
Claude Desktop（可译为“Claude桌面版”）
添加到您的MCP设置中（~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"open-stocks": {
"command": "open-stocks-mcp-server",
"args": ["--transport", "stdio"]
}
}
}HTTP传输集成
{
"mcpServers": {
"open-stocks": {
"command": "python",
"args": ["-m", "mcp_http_client", "http://localhost:3001/mcp"]
}
}
}可用工具
🏦 支持多经纪商
Robinhood 工具（80 种工具）:
- 所有现有的Robinhood功能均得以保留
- 现有API无重大变更
施瓦布工具（24件工具）:
- 账户与投资组合（5种工具）- 账户号码、余额、持仓
- 市场数据（5种工具）- 报价、价格历史、工具搜索
- 交易（8种工具）- 市价/限价买入/卖出，订单管理
- 选项（6种工具）- 链条（或期权系列）、到期日、仓位、买入/卖出
所有施瓦布工具均采用 schwab_ 前缀（例如。， schwab_get_portfolio， schwab_buy_stock_market）。
______________________________________________________________________
按类别划分的Robinhood工具
账户与投资组合（15种工具）
- 账户信息和详情
- 投资组合头寸和持仓
- 日内交易指标和历史记录
- 股票和期权订单历史
市场数据（12种工具）
- 实时股票报价和基本面数据
- 市场推动者和顶尖表现者
- 行业分析与市场趋势
- 历史价格数据
期权交易（15种工具）
- 期权链和市场数据
- 位置聚合与分析
- 历史期权数据
- 期权工具搜索
观察名单与个人资料（8种工具）✅ 观察名单管理已测试
- 关注列表管理 - 所有5个工具均正常工作（已使用AMC测试添加/移除符号功能）
- 用户配置文件和设置
- 投资偏好
- 账户功能
市场调研（10种工具）
- 收益数据及分析
- 股票评级和新闻
- 股息信息
- 公司行为和分拆
分析与监控（5种工具）
- 投资组合分析
- 性能指标
- 服务器健康监控
- 利息和贷款还款
通知（12种工具）
- 账户通知
- 追加保证金要求和利息
- 订阅管理
- 引荐追踪
高级仪器（4种工具）
- 多符号仪器查询
- 增强的搜索功能
- 二级市场数据（需黄金权限）
- 直接访问仪器
交易功能（15种工具）
股票订单（✅ 已现场测试）：
- ✅ 市价单 - 已使用XOM和AMC进行买入/卖出测试
- ✅ 限价单 - 以XOM（106美元）和AMC（3美元）为测试对象进行买入/卖出操作
- ✅ 止损订单 - 使用AMC进行卖出测试（25股，每股2.50美元）
- 单个订单和批量订单的取消
- ❌（表示错误或否） 已弃用追踪止损订单，零股交易（不常见使用场景）
期权订单（✅ 已实战测试）：
- ✅ 期权限价单（买入/卖出）- API错误已修复
- ✅ 期权发现与合约搜索
- ✅ 信用价差策略和借记价差策略 - API错误已修复，准备进行测试
- 实时验证：成功下达F $9的卖出期权订单
订单管理：
- 取消单个或全部订单（库存和期权）
- 查看空缺职位
- 订单状态追踪
认证
该服务器处理Robinhood的认证要求：
- 设备验证新设备审批的自动处理
- 多因素认证支持基于短信和应用程序的多因素认证（MFA）
- 会话持久性缓存认证以减少重新验证
发展
测试
pytest # All tests
pytest -m "journey_account" # Fast account tests (~1.8s)
pytest -m "journey_market_data" # Market data tests (~3.8s)
pytest -m "not slow and not exception_test" # Recommended for development
# See CLAUDE.md for complete journey testing guide代码质量
ruff check . --fix # Lint and fix
ruff format . # Format code
mypy . # Type checkGoogle ADK评估
# Set environment variables
export GOOGLE_API_KEY="your-google-api-key"
export ROBINHOOD_USERNAME="email@example.com"
export ROBINHOOD_PASSWORD="password"
# Start Docker server
cd examples/open-stocks-mcp-docker && docker-compose up -d
# Run evaluation
MCP_HTTP_URL="http://localhost:3001/mcp" adk eval examples/google_adk_agent tests/evals/list_available_tools_test.json --config_file_path tests/evals/test_config.json项目范围
在v0.7.0-dev版本中完成：
- ✅ 多经纪人架构 - 支持多个代理的抽象代理层
- ✅ 施瓦布整合 - 覆盖账户、市场数据、交易和期权等24种工具
- ✅ OAuth 认证 - 使用自动令牌刷新的Schwab OAuth 2.0流程
- ✅（勾选标记，表示正确、完成或确认） 优雅降级 - 即使代理身份验证失败，服务器也会启动
- ✅ 向后兼容性 - 所有Robinhood工具保持不变，无重大变更
在v0.6.4版本中完成：
- ✅（对号，表示正确、确认或完成） 增强型选项工具 新
open_option_positions_with_details()丰富期权（看涨/看跌）类型头寸 - ✅ 股票交易API修复 - 市价、限价和止损买入/卖出功能现已正常工作
- ✅ 实时股票交易验证 - XOM和AMC的订单已成功下达（市价单、限价单、止损单）
- ✅ 工具弃用 - 移除了4个不常见的交易功能（股票止损买入、追踪止损、零股交易）
- ✅ 期权交易API修复 -
buy_option_limit，sell_option_limit并且现在正在实施的传播策略 - ✅ 实时选项验证 - 成功交易F $9看跌期权
- ✅ 期权发现 -
find_options函数运行正常 - ✅ 期权价差已确定 信用和借记价差功能已修正（API签名、数据结构、符号提取）
- ✅ 监控名单管理完成 - 所有5个监控列表工具均在实时测试中运行
- ✅ 监视名单API修复 - 修复了响应格式更改和参数绑定问题
- ✅ 所有交易功能已就绪 - 第7阶段完成，准备进入第8阶段
下一个优先事项（施瓦布测试）：
- ⏳ 施瓦布旅程测试（因API凭据被阻止）
- ⏳ 实时施瓦布（Schwab）交易验证
- ⏳ 多经纪商集成测试
- ⏳ 施瓦布特定文档
范围之外：
- 加密货币交易工具
- 银行/ACH（自动清算所）转账
- 账户修改
- 存款/取款功能
贡献
看 CONTRIBUTING.md（贡献指南文件） 作为发展指南。
许可证
MIT 许可证 - 参见 许可证 文件中详述。
安全
重要的安全注意事项：
- 实时交易功能 - 真实订单是使用实际金钱支付的
- 切勿将凭据提交到版本控制系统
- 为（文件/目录）设置适当的文件权限
.env文件 - 交易验证完成 - 既测试了股票交易也测试了期权交易
- 在生产环境中执行交易前务必验证
- 期权交易备忘录卖出期权（如看跌期权）可能导致被行权并获得股票所有权
出于安全考虑，请参阅我们的 安全策略。
______________________________________________________________________
免责声明： 此软件仅用于教育和开发目的。股票和期权交易涉及重大风险。在执行任何金融交易之前，请务必核实交易并了解相关风险。