TastyTrade智能交易助手 - MCP服务器

项目简介

TastyTrade智能交易助手 (tasty-agent) 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在连接大型语言模型 (LLM) 与 TastyTrade 股票交易平台。它作为一个桥梁，使得LLM能够安全地访问您的TastyTrade账户信息，并执行交易操作，从而实现智能化的投资管理和交易自动化。

主要功能点

投资组合监控: 获取账户余额、持仓信息和交易历史，让LLM了解您的投资状况。
市场数据分析: 查询股票和期权的实时报价，以及关键的市场指标（如IV Rank、Beta等），辅助LLM进行投资决策。
自动化交易: 允许LLM根据您的指令或策略，自动执行股票和期权的买卖交易，包括即时交易和定时交易。
交易计划管理: 支持预设交易计划，在市场开盘时自动执行，即使LLM客户端未持续运行也能保证交易指令的执行。
图表可视化: 生成账户净值历史的图表，直观展示投资组合的表现。

安装步骤

安装 uv 包管理器: 如果您的系统上尚未安装 'uv'，请先安装 'uv' 包管理器。打开终端并执行以下命令：

curl -LsSf https://astral.sh/uv/install.sh | sh

运行 tasty-agent: 使用 'uvx' 命令直接运行 tasty-agent 服务器。在终端中执行：
```
uvx tasty-agent
```
配置 Tastytrade 账户: 首次运行需要配置您的 Tastytrade 账户信息。执行以下命令，按照提示输入您的 Tastytrade 用户名和密码。这些凭据将被安全地存储在您系统的密钥链中：
```
uvx tasty-agent setup
```

服务器配置

要将 TastyTrade智能交易助手配置为 MCP 服务器供 MCP 客户端（例如 Claude Desktop）使用，您需要在 MCP 客户端的配置文件中添加以下 JSON 配置信息。

Claude Desktop 配置示例 ('claude_desktop_config.json'):

{
  "mcpServers": {
    "tastytrade": {  //  服务器名称，您可以自定义
      "command": "path/to/uvx/command/uvx",  //  uvx 命令的完整路径，请替换为您的 uvx 可执行文件的实际路径
      "args": ["tasty-agent"]  //  运行 tasty-agent 服务器的参数，固定为 ["tasty-agent"]
    }
  }
}

请注意:

'command' 字段需要指向您系统中 'uvx' 可执行文件的完整路径。您可以使用 'which uvx' (Linux/macOS) 或 'where uvx' (Windows) 命令查找 'uvx' 的路径。
'args' 字段固定为 '["tasty-agent"]'，用于指定运行 tasty-agent 服务器。
'server name' ("tastytrade" 在本例中) 可以自定义，用于在 MCP 客户端中标识和调用此服务器。

基本使用方法

启动 MCP 服务器: 按照安装步骤启动 tasty-agent 服务器。
配置 MCP 客户端: 将上述服务器配置信息添加到您的 MCP 客户端配置文件中。
通过 MCP 客户端与服务器交互: 使用 MCP 客户端（例如 Claude Desktop）连接到 "tastytrade" 服务器。您可以使用自然语言指令，指示 LLM 调用 tasty-agent 提供的工具，例如：
- “查询我的账户余额” (调用 'get_account_balances' 工具)
- “查看 AAPL 股票的当前价格” (调用 'get_prices' 工具，参数为 'symbol="AAPL"')
- “购买 10 股 SPY 股票” (调用 'schedule_trade' 工具，参数为 'action="Buy to Open"', 'quantity=10', 'underlying_symbol="SPY"')
- “绘制过去一个月的账户净值历史图表” (调用 'plot_nlv_history' 工具，参数为 'time_back="1m"')

重要提示:

定时交易功能依赖于服务器的持续运行。如果您关闭 Claude Desktop 或 tasty-agent 服务器，已计划的定时交易将不会执行。
请务必谨慎使用自动化交易功能，并充分了解相关风险。

关键词