交易工具服务器

TastyTrade MCP服务器

A. 模型上下文协议 （MCP）服务器，连接到您的TastyTrade经纪账户，并公开72个交易工具。与官方合作建造 TastyTrade JavaScript SDK 和 DXLink 的 实时市场数据、报价和期权。

适用于 ChatGPT桌面, 克劳德桌面版，或任何兼容MCP的客户端——本地和云中。

特性

• 72个MCP工具 涵盖整个TastTrade API
• 自动身份验证 使用存储的TastyTrade凭据（客户端机密+刷新令牌）
• OAuth 2.1授权服务器 用于ChatGPT和远程MCP客户端（PKCE、动态客户端注册）
• 实时市场数据 通过DXLink（报价、蜡烛、希腊选项）
• 双重运输：stdio（本地）和流式HTTP（云）
• 承载令牌安全 用于云部署

先决条件

• Node.js 20或更晚
• 具有API访问权限的TastTrade帐户（客户端机密和刷新令牌）

安装

git clone <your-repo-url>
cd tastytrade-mcp-server
npm install
npm run build

用法

选项1：本地（stdio）

直接运行服务器，并通过stdio连接MCP客户端。

node build/index.js

ChatGPT桌面

将此添加到您的ChatGPT桌面MCP配置中：

{
  "mcpServers": {
    "tastytrade": {
      "command": "node",
      "args": ["/absolute/path/to/build/index.js"]
    }
  }
}

克劳德桌面版

添加到您的Claude桌面配置(claude_desktop_config.json):

{
  "mcpServers": {
    "tastytrade": {
      "command": "node",
      "args": ["/absolute/path/to/build/index.js"]
    }
  }
}

MCP检查员（用于测试）

npx @modelcontextprotocol/inspector node build/index.js

选项2：云（流式HTTP）

将服务器作为web服务运行，以便MCP客户端可以远程连接。

MCP_TRANSPORT=http MCP_BEARER_TOKEN=your-secret-token node build/index.js

服务器在端口5000上启动（可通过配置 PORT 有人）。

• MCP端点: https://your-server-url/mcp
• 健康检查: https://your-server-url/health

将您的MCP客户端连接到 /mcp 端点，并将承载令牌包含在 Authorization 头球

Authorization: Bearer your-secret-token

环境变量

动态刀具发现模式

默认情况下，所有工具在启动时都会注册，并在每次调用时向LLM广播（每个请求约12000-15000个模式开销令牌）。对于对令牌敏感的部署，您可以启用 动态工具发现 模式，将初始模式开销减少到约200-500个令牌。

启用发现模式

TOOL_DISCOVERY_MODE=true node build/index.js

启用后，启动时只显示三个轻量级元工具：

完整的工具模式存储在内部注册表中，但 不广播 在最初的背景下，LLM。该模型根据需要发现和获取模式。

交互流程示例

User: What's the current price of AAPL?

Model → list_tool_categories()
← "Market Data (7 tools), Account (9 tools), ..."

Model → search_tools("quote price real-time")
← "get_quote [Market Data]: Get real-time quote data for one or more symbols using DXLink..."

Model → get_tool_details("get_quote")
← Full JSON schema with parameters (symbols, timeoutMs)

Model → get_quote(symbols=["AAPL"])
← { bid: 174.20, ask: 174.22, last: 174.21, ... }

在同一会话中的后续回合中，模型可以跳过发现步骤并调用 get_quote 如果它已经知道对话早期的模式，则直接使用。

向后兼容

当 TOOL_DISCOVERY_MODE 未设置（或设置为 false)，所有工具在启动时都会像以前一样注册。现有集成不受影响。

TastyTrade认证

服务器在启动时使用TastyTrade自动进行身份验证 TASTYTRADE_CLIENT_SECRET 和 TASTYTRADE_REFRESH_TOKEN 环境变量。不需要手动身份验证步骤。

若要获取您的客户机密和刷新令牌，请通过TastTrade的开发者门户注册API访问。

使用 check_auth_status 用于验证连接状态或在需要时重试身份验证的工具。

OAuth 2.1授权服务器

对于像ChatGPT这样的远程MCP客户端，该服务器包括一个内置的OAuth 2.1授权服务器，支持：

• PKCE （S256）用于安全授权码交换
• 动态客户端注册 （RFC 7591）用于自动客户入职
• 发现端点 (/.well-known/oauth-authorization-server, /.well-known/oauth-protected-resource)

OAuth流

1. 客户端通过以下方式发现OAuth配置 /.well-known/oauth-protected-resource 和 /.well-known/oauth-authorization-server
2. 客户端通过以下方式动态注册 POST /oauth/register
3. 客户端将用户重定向到 GET /oauth/authorize PKCE挑战
4. 用户输入他们的 MCP_BEARER_TOKEN 在授权页面上
5. 服务器使用授权码重定向回
6. 客户端在以下位置交换访问令牌代码 POST /oauth/token 使用PKCE验证器
7. 客户端使用访问令牌作为MCP请求的承载令牌

可用工具（72）

身份验证（2）

账目（4）

平衡与头寸（3）

订单（14）

仪器（24）

市场数据（7）

交易记录（3）

观察名单（9）

风险与利润（6）

提示缓存

Anthropic和OpenAI都支持 快速缓存：当发送到模型的工具定义在连续回合之间相同时，提供者会缓存模式计算，并对后续请求收取正常费率的一小部分。使用73个工具（大约12000-15000个模式开销令牌），缓存可以通过以下方式降低每轮令牌成本 50–90% 在多回合对话中。

它如何与此服务器配合使用

此服务器的设计使工具定义始终在 相同的确定性顺序 在每次启动时：

1. 身份验证工具
2. 账户工具
3. 平衡和定位工具
4. 订购工具
5. 仪器工具
6. 市场数据工具
7. 交易工具
8. 监视列表工具
9. 风险和利润工具

因为顺序永远不会改变，所以将工具列表转发给Anthropic或OpenAI的MCP客户端将在会话内和会话间的每个请求上发送相同的模式前缀，允许提供者从其缓存中提供模式。

验证缓存是否处于活动状态（Anthropic）

当您通过带有工具定义的Anthropic API使用Claude时，响应包括使用统计信息。查找非零 cache_read_input_tokens 字段：

{
  "usage": {
    "input_tokens": 512,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 14203
  }
}

非零 cache_read_input_tokens 该值确认工具模式是从Anthropic的提示缓存中提供的。在新缓存窗口中的第一个请求上，您将看到 cache_creation_input_tokens 相反，这是缓存种子的一次性成本。

HTTP缓存控制标头

服务器设置以下内容 Cache-Control 每种响应类型的标头：

客户端要求

提示缓存由处理 客户端应用程序，不是这个服务器。当前的MCP SDK没有公开API来注入特定于提供商的 cache_control 注释（例如Anthropic的 {"type": "ephemeral"})到协议级别的工具列表中——这存在于客户端组装的LLM API请求中。要启用缓存，请执行以下操作：

• 无烟煤API：添加 {"type": "ephemeral"} 作为 cache_control 注释到发送到Anthropic API的列表中的最后一个工具定义。此服务器中工具模式的稳定、确定性排序确保了内容哈希在每一轮都匹配。
• OpenAI API：对于超过1024个令牌的提示，会自动进行提示缓存；不需要额外的配置。

在Replit上部署

此项目已配置为在Replit上作为永远在线的VM进行部署：

1. 在“答复机密”面板中设置以下机密：
   • MCP_BEARER_TOKEN
   • TASTYTRADE_CLIENT_SECRET
   • TASTYTRADE_REFRESH_TOKEN
2. 点击 发布 部署
3. 您的MCP端点将在 https://your-replit-url/mcp

项目结构

src/
  index.ts                    - Entry point (dual transport + OAuth 2.1 + bearer auth + TOOL_DISCOVERY_MODE)
  tastytrade-client.ts        - TastyTrade client wrapper (auto-authentication on startup)
  oauth-provider.ts           - Built-in OAuth 2.1 authorization server (DCR, PKCE, token management)
  auth-page.ts                - HTML authorization page rendered during OAuth flow
  tools/
    tool-registry.ts          - Internal registry of all tool definitions (used by discovery mode)
    discovery-tools.ts        - Meta-tools: list_tool_categories, search_tools, get_tool_details
    auth-tools.ts             - Authentication tools
    account-tools.ts          - Account & customer tools
    balance-position-tools.ts - Balances & positions
    order-tools.ts            - Order management
    instrument-tools.ts       - Instrument lookups
    market-data-tools.ts      - Market data (DXLink)
    transaction-tools.ts      - Transaction history
    watchlist-tools.ts        - Watchlist management
    risk-margin-tools.ts      - Margin & risk parameters

许可证

麻省理工学院