tradestation MCP

TradeStation MCP 服务器

一个模型上下文协议（MCP）服务器，为Claude Code及其他MCP客户端提供TradeStation API集成。

特点/功能

• 实时市场数据（报价、K线图、期权链）
• 账户信息（余额、持仓、订单）
• 订单预览与验证
• 自动令牌刷新管理
• 支持模拟环境和真实环境

可用工具

市场数据

• marketData - 获取实时股票代码报价
• barChart - 获取历史价格柱/蜡烛图
• getSymbolDetails - 获取详细的符号信息
• getOptionExpirations - 获取可用期权的到期日期
• getOptionStrikes - 获取可用的期权执行价格

账户管理

• getAccounts - 列出所有经纪账户
• getBalances - 获取账户余额和购买力
• getPositions - 获取当前持仓及盈亏情况
• getOrders - 获取订单历史记录，并可选择状态过滤
• getOrderDetails - 获取特定订单的详细信息
• getExecutions - 获取特定订单的填充/执行情况

订单操作

• confirmOrder - 预览订单成本和要求（仅读取，不执行交易）

设置

先决条件

• Node.js 18 或更高版本
• 带有API凭证的TradeStation开发者账户
• 有效的TradeStation账户（模拟或真实）

安装

1. 克隆此存储库：

git clone 
cd mcp-tradesation

1. 安装依赖项：

npm install

1. 复制示例环境文件：

cp .env.example .env

1. 编辑 .env 并添加您的TradeStation API凭据：

TRADESTATION_CLIENT_ID=your_client_id_here
TRADESTATION_CLIENT_SECRET=your_client_secret_here
TRADESTATION_REFRESH_TOKEN=your_refresh_token_here
TRADESTATION_REDIRECT_URI=http://localhost:3000/callback

1. 构建服务器：

npm run build

获取TradeStation API凭证

1. 首选 TradeStation 开发者门户
2. 创建一个新的应用程序以获取您的客户端ID和客户端密钥
3. 完成OAuth流程以获取刷新令牌
4. 将凭据添加到您的 .env 文件

在Claude代码中进行配置

在您的Claude Code MCP配置文件中添加以下内容：

macOS/Linux： ~/.config/claude-code/mcp_config.json Windows（系统/平台）： %APPDATA%\claude-code\mcp_config.json

{
  "mcpServers": {
    "tradestation": {
      "command": "node",
      "args": ["/path/to/mcp-tradesation/build/index.js"],
      "env": {
        "TRADESTATION_CLIENT_ID": "your_client_id_here",
        "TRADESTATION_CLIENT_SECRET": "your_client_secret_here",
        "TRADESTATION_REFRESH_TOKEN": "your_refresh_token_here",
        "TRADESTATION_REDIRECT_URI": "http://localhost:3000/callback"
      }
    }
  }
}

或者，如果你有一个 .env 在项目目录中，文件名前的路径可以省略 env 部分，服务器将自动从（此处根据上下文，可能需要补充具体来源，如“配置文件”或“数据库”等，但原文未给出具体信息，故直译为）加载凭据 .env 文件。

用法

配置完成后，MCP 工具将自动在 Claude Code 中可用。您可以这样使用它们：

Get a quote for SPY
Show me a 5-minute chart for AAPL with the last 20 bars
What are my account balances?
List my current positions
Preview an order to buy 100 shares of SPY at market price

发展

项目结构

mcp-tradesation/
├── src/
│   ├── index.ts           # Main MCP server implementation
│   └── test-*.js          # Test scripts for API endpoints
├── build/                 # Compiled JavaScript output
├── .env.example          # Example environment configuration
├── package.json          # Package dependencies and scripts
└── tsconfig.json         # TypeScript configuration

测试

该项目包含多个测试脚本，用于验证API功能：

# Test token refresh and basic API access
node src/quick-token-test.js

# Test all MCP server functions
node src/test-mcp-functions.js

# Test specific endpoints
node src/test-specific-endpoints.js

建筑

npm run build

这个将TypeScript源代码编译成JavaScript build/ 目录。

环境变量

故障排除

令牌错误

如果你看到认证错误：

1. 验证您的身份 .env 文件是正确的
2. 确保您的刷新令牌未过期
3. 请检查您的TradeStation账户是否已启用API访问权限

构建错误

如果构建失败：

1. 确保已安装 Node.js 18 或更高版本
2. 删除 node_modules 和 build 目录（或文件夹）
3. 跑 npm install 再次
4. 跑 npm run build

MCP连接问题

如果Claude Code无法连接到服务器：

1. 验证路径至 build/index.js 在你的MCP配置中是正确的
2. 检查服务器是否成功构建build/index.js 存在
3. 检查Claude Code日志中的错误信息

API 文档

对于详细的TradeStation API文档，请访问：

• TradeStation 开发者门户
• API 文档

许可证

ISC（Internet Service Center，互联网服务中心）

贡献

欢迎贡献！请随时提交问题或拉取请求。