Stock Agent

基于MCP（模型上下文协议）的AI交易代理

构建一个自主的人工智能交易代理，可以执行真实交易、分析期权和监控宏观经济状况——所有这些都是通过自然语言对话实现的。

🎯 这个项目做什么

此存储库包含OpenAPI规范，使AI助手（Claude、ChatGPT等）能够：

• 执行交易 通过羊驼（股票、ETF、期权）
• 分析期权链 通过Tradier与希腊人交流
• 监测宏观经济状况 通过FRED（美联储数据）

使用 Workato的MCP连接器，这些规范成为人工智能可以调用的MCP服务器作为工具。

🏗️ 建筑

┌─────────────────────────────────────────────────────────────┐
│                     USER CONVERSATION                        │
│           "Buy $5000 of NVDA" or "Check the yield curve"    │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                    CLAUDE / CHATGPT                          │
│              AI reasoning and decision making                │
└─────────────────────────────────────────────────────────────┘
                              │
                              ▼
┌─────────────────────────────────────────────────────────────┐
│                    MCP PROTOCOL LAYER                        │
│           Standardized tool calls via Workato                │
└─────────────────────────────────────────────────────────────┘
                              │
              ┌───────────────┼───────────────┐
              ▼               ▼               ▼
┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
│     ALPACA      │ │     TRADIER     │ │      FRED       │
│   Trading API   │ │   Options API   │ │   Economic API  │
│                 │ │                 │ │                 │
│ • Orders        │ │ • Options Chains│ │ • Yield Curve   │
│ • Positions     │ │ • Greeks        │ │ • Unemployment  │
│ • Portfolio     │ │ • Historical    │ │ • Inflation     │
│ • Account       │ │ • Quotes        │ │ • GDP           │
└─────────────────┘ └─────────────────┘ └─────────────────┘

📁 存储库内容

🚀 快速开始

先决条件

1. Workato帐户 - 注册Workato （需要MCP连接器）
2. 羊驼账户 - 注册Alpaca （免费票据交易）
3. Tradier账户 - 注册Tradier （免费沙盒）
4. FRED API密钥 - 获取免费密钥

第一步：设置羊驼

1. 在以下位置创建帐户 羊驼市场
2. 转到纸交易仪表板
3. 生成API密钥（密钥ID+密钥）
4. 注：使用 paper-api.alpaca.markets 用于测试

第二步：设置Tradier

1. 在以下位置创建帐户 developer.trader.com
2. 从仪表板获取沙盒访问令牌
3. 注：使用 sandbox.tradier.com 免费延迟数据

步骤3：设置FRED

1. 首选 FRED API密钥
2. 请求免费的API密钥（即时批准）

步骤4：导入到Workato

对于每个API：

1. 在Workato中，转到 应用程序连接 → 创建连接
2. 选择 超文本传输协议 连接器 开放API 选项
3. 上传相应 .yaml 文件
4. 配置身份验证：

步骤5：创建MCP服务器

1. 在Workato中，转到 MCP服务器 → 创建服务器
2. 将HTTP连接添加为工具
3. 发布MCP服务器
4. 复制MCP服务器URL

第六步：联系克劳德

在第ai条中：

1. 首选 设置 → 集成 → MCP服务器
2. 添加您的Workato MCP服务器URL
3. 授权连接
4. 开始聊天！

💬 对话示例

与羊驼进行交易

User: What's my current portfolio value?

Claude: [Calls Alpaca:Get_Account]
Your portfolio is worth $99,595.06 with $43,581 buying power.
You have 24 open positions.

User: Buy $5000 of NVDA

Claude: [Calls Alpaca:Create_Order]
✓ Bought 26.3 shares of NVDA at $190.15
Order filled. Total cost: $5,001.95

Tradier期权分析

User: What covered calls can I sell on SOFI?

Claude: [Calls Tradier:Get_Option_Chains with greeks=true]

Here are the best opportunities for SOFI (current price $26.92):

| Strike | Expiry | Premium | Delta | Annual Return |
|--------|--------|---------|-------|---------------|
| $29    | Feb 20 | $1.38   | 0.40  | 48.4%         |
| $30    | Feb 20 | $1.10   | 0.34  | 38.3%         |
| $28    | Feb 20 | $1.72   | 0.47  | 60.0%         |

Recommendation: The $29 strike offers the best risk/reward balance.

使用FRED进行宏观分析

User: What's the current macro environment?

Claude: [Calls FRED:Get_Series_Observations for T10Y2Y, VIXCLS, DFF, UNRATE]

📊 Market Regime Check (January 2026)

| Indicator | Value | Signal |
|-----------|-------|--------|
| Yield Curve (10Y-2Y) | +0.64% | ✅ Normal |
| VIX | 14.49 | ✅ Low volatility |
| Fed Funds Rate | 4.33% | 🟡 Restrictive |
| Unemployment | 4.1% | ✅ Healthy |

Regime: RISK-ON
Current conditions favor growth assets.

📊 可用工具

羊驼（交易）

Tradier（期权）

FRED（宏观）

🔑 钥匙FRED系列

⚠️ 重要免责声明

• 仅限于纸品交易：从纸上交易开始测试您的设置
• 非财务建议这是一个教育项目
• 期权风险：期权交易涉及重大风险
• API限值：注意所有API的速率限制
• 数据延迟：Tradier沙盒有15分钟的延迟数据

🔧 故障排除

常见问题

401未经授权（羊驼）

• 检查API密钥格式（需要密钥ID和密钥）
• 使用正确的基本URL进行验证（纸质与实时）
• 确保标题命名正确

422不可处理实体（羊驼订单）

• 不要发送空邮件 stop_loss 或 take_profit 对于简单订单
• 使用其中之一 qty 或 notional，不是两者都有
• 查看当日订单的市场交易时间

400错误请求（Tradier）

• 验证承载令牌格式
• 检查选项的符号格式

无数据（FRED）

• 添加 file_type=json 对于请求
• 检查seris_id拼写（区分大小写）

📚 资源

• API羊驼文档
• 传统API文档
• FRED API单据
• Workato MCP文档
• MCP协议规范

🤝 贡献

欢迎投稿！拜托：

1. 克隆该仓库
2. 创建要素分支
3. 提交拉取请求

📄 许可证

MIT许可证-有关详细信息，请参阅许可证文件。

🙏 致谢

• Anthropic 克劳德和MCP
• 羊驼 API免佣金交易
• 特拉迪尔 对于选项数据API
• 弗雷德 经济数据
• 计算机 用于MCP服务器托管

______________________________________________________________________

建于❤️ AI交易代理社区

*记住：在使用真钱之前，一定要用纸笔交易进行测试！*