TickTest MCP Server

让 AI Agent（Claude Code、Cursor、Windsurf 等）通过 MCP 协议直接调用 TickTest A 股量化回测 API。

安装

pip install ticktest-mcp

配置

Claude Code

在 .claude/mcp.json 或项目根目录 .mcp.json 中添加：

{
  "mcpServers": {
    "ticktest": {
      "command": "python",
      "args": ["-m", "ticktest_mcp"],
      "env": {
        "TICKTEST_API_URL": "https://api.ticktest.cn",
        "TICKTEST_API_KEY": "tt_your_api_key_here"
      }
    }
  }
}

Cursor / Windsurf

在 MCP 配置中添加：

{
  "mcpServers": {
    "ticktest": {
      "command": "ticktest-mcp",
      "env": {
        "TICKTEST_API_URL": "https://api.ticktest.cn",
        "TICKTEST_API_KEY": "tt_your_api_key_here"
      }
    }
  }
}

获取 API Key

无需离开对话，Agent 会帮你完成注册：

1. Agent 询问你的邮箱
2. Agent 调用 send-code → 你收到 6 位验证码
3. 告诉 Agent 验证码 → 注册成功，拿到 API Key + 500 信用点
4. Agent 配置 Key，开始回测

Tools

Tool	认证	说明
get_capabilities	公开	获取策略、因子、定价、注册流程
health_check	公开	检查 API 服务状态
search_symbols	公开	搜索 A 股股票代码
validate_strategy	需 Key	免费验证策略参数
run_backtest	需 Key	运行回测，¥0.50/次
create_payment	需 Key	生成支付页面

快速体验

海龟交易策略永久免费，无需付费：

Agent: 帮我回测中际旭创，海龟交易
→ 自动搜索 sz300308 → 回测 → 返回收益率/夏普/回撤/胜率

定价

• 单次回测：¥0.50（25 信用点）
• 入门月卡：¥29（2500 点 ≈ 100 次）
• 注册送 500 信用点（≈ 20 次）
• 海龟交易：永久免费

环境变量

变量	必填	说明
TICKTEST_API_URL	否	API 地址，默认 https://api.ticktest.cn
TICKTEST_API_KEY	否	API Key，不配则只能调公开 Tool
TICKTEST_BACKTEST_TIMEOUT	否	回测超时秒数，默认 90

License

MIT