MCP etrade

E\*TRADE MCP服务器

一个全面的模型上下文协议（MCP）服务器，用于E\*TRADE与OAuth身份验证、账户管理、风险计算、观察名单和交易护栏的集成。

特性

🔐 OAuth身份验证

• 完成E\*TRADE OAuth 1.0a流程
• 代币管理和更新
• 安全的凭证处理

💰 账户管理

• 账户余额检索
• 交易历史记录
• 投资组合查看
• 实时账户数据

📊 风险管理

• R-多重风险计算
• 每日损失跟踪
• 定位护栏尺寸
• 订单前风险验证

📋 观察名单

• 创建、读取、更新、删除观察名单
• 符号管理
• 独立于投资组合头寸

📈 市场数据

• 有到期日期的期权链
• 实时行情
• 按公司名称进行安全查找

🚨 警报

• 价格预警管理
• 预警通报
• 自定义警报条件

安装

先决条件

• Python 3.11+
• E\*TRADE具有API密钥的开发人员帐户

通过UVX安装（推荐）

uvx --from git+https://github.com/davdunc/mcp_etrade.git mcp_etrade

通过pip安装

pip install git+https://github.com/davdunc/mcp_etrade.git

开发安装

git clone https://github.com/davdunc/mcp_etrade.git
cd mcp_etrade
pip install -e .

配置

设置您的E\*TRADE API凭证：

export ETRADE_OAUTH_CONSUMER_KEY="your_consumer_key"
export ETRADE_OAUTH_CONSUMER_SECRET="your_consumer_secret"

用法

独立服务器

python -m mcp_etrade.server

采用斗兽场框架

增添 ~/.config/colosseum/mcp.json:

{
  "etrade": {
    "type": "etrade",
    "command": "uvx",
    "args": ["--from", "git+https://github.com/davdunc/mcp_etrade.git", "mcp_etrade"],
    "env": {
      "ETRADE_OAUTH_CONSUMER_KEY": "${ETRADE_OAUTH_CONSUMER_KEY}",
      "ETRADE_OAUTH_CONSUMER_SECRET": "${ETRADE_OAUTH_CONSUMER_SECRET}"
    }
  }
}

可用工具

认证

• get_request_token -启动OAuth流
• get_authorization_url -获取用户授权URL
• get_access_token -完整的OAuth流程
• renew_access_token -刷新令牌
• revoke_access_token -撤销访问权限

账户管理

• get_account_balance -获取账户余额和详细信息
• list_transactions -列出账户交易记录
• get_transaction_details -获取特定交易详细信息
• view_portfolio -查看投资组合头寸

风险管理

• calculate_risk_parameters -计算R-多重风险参数
• validate_order_risk -根据风险限额验证订单
• get_daily_risk_status -获取当前每日风险利用率
• record_actual_loss -记录实际交易损失

观察名单

• create_watch_list -创建新的观察名单
• get_watch_lists -获取所有观察名单
• update_watch_list -更新现有观察名单
• delete_watch_list -删除观察名单

市场数据

• get_option_chains -获取符号的选项链
• get_option_expire_dates -获取期权到期日期
• get_quotes -获取实时报价
• lookup_product -按公司名称搜索证券

警报

• list_alerts -标价提醒
• delete_alerts -删除警报
• get_alert_details -获取警报详细信息

风险管理

该服务器包括全面的风险管理功能：

• 每日风险限额：可配置的账户余额百分比
• 位置大小限制：每笔订单最多50%的账户
• 损失追踪：潜在和实际损失跟踪
• 验证：带有详细信息的预购风险验证

风险验证示例：

# Validate order before placement
result = await call_tool("validate_order_risk", {
    "account_id": "your_account",
    "order_value": 1000.00,
    "risk_amount": 50.00,
    "risk_percentage": 1.0
})

测试

运行综合测试套件：

pytest

测试覆盖范围：

• 105项测试通过
• OAuth身份验证流程
• 账户管理操作
• 风险计算准确性
• 观察列表CRUD操作
• 市场数据检索
• 警报管理

建筑

• 干净的JSON输出：对代理消费的结构化响应
• 全面的错误处理：优雅的故障模式
• 模拟数据支持：无需实时API调用即可实现完整功能
• 模块化设计：分别关注OAuth、风险、数据等。

整合

设计用于与以下设备集成：

• 罗马斗兽场：多代理交易框架
• LangChain：代理工具和编排
• MCP客户端：任何MCP兼容系统

许可证

GNU通用公共许可证v3.0

贡献

1. 分叉存储库
2. 创建要素分支
3. 添加新功能的测试
4. 确保所有测试通过
5. 提交拉取请求

支持

对于问题和疑问：

• GitHub问题：https://github.com/davdunc/mcp_etrade/issues
• 文档：请参阅内联代码文档