Metadata-Version: 2.5
Name: ticktest-mcp
Version: 0.4.0
Summary: TickTest A股量化回测 MCP Server — 让 AI Agent 用自然语言回测 A 股
Project-URL: Homepage, https://ticktest.cn
Project-URL: Documentation, https://ticktest.cn/docs
Project-URL: Repository, https://github.com/ticktest/ticktest-mcp
Author-email: TickTest Team <hello@ticktest.cn>
License: MIT
Keywords: a-stock,ai-agent,backtest,mcp,quant,ticktest
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial :: Investment
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27.0
Requires-Dist: mcp>=1.0.0
Description-Content-Type: text/markdown

# TickTest MCP Server

<!-- mcp-name: io.github.shakagold/ticktest-mcp -->

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

## 安装

```bash
pip install ticktest-mcp
```

## 配置

### Claude Code

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

```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 配置中添加：

```json
{
  "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 | 生成三卡支付页：¥0.50 单次 / ¥1 体验卡 / ¥19 月卡 |

## 快速体验

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

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

## 定价

- 单次回测：¥0.50（25 信用点）
- 畅测体验卡：¥1（24 小时回测不限次，新人限购 1 次）
- 畅测月卡：¥19（30 天回测不限次，真·不限次仅并发≤2）
- 注册送 500 信用点（≈ 20 次）
- 海龟交易：永久免费

## 环境变量

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

## License

MIT
