Ztrade MCP

MCP金融服务

提供方 ztrade

金融服务 未标注 API Key 社区 / 第三方 Claude DesktopClaudeVS Code

ztrade-mcp是量化交易框架ztrade的MCP(Model Context Protocol)服务器实现,使AI助手能通过标准化协议调用ztrade的核心功能,包括K线数据管理、策略回测、实盘交易等。

一句话选型结论

按资料字段整理

Ztrade MCP 属于金融服务类 MCP 服务器,传输方式未标注,API Key,可直接接入 Claude Desktop、Claude、VS Code,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类金融服务 传输方式未标注 鉴权API Key 部署方式未标注
GitHub 星标 1 仓库热度,无公开仓库时显示未标注
工具数 10 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

金融服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量10暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

量化交易Go本地部署AI辅助策略回测实盘交易K线数据管理

安装与配置

未标注 API Key
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 10 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
行情与财务数据

查行情、财报、汇率等金融数据。

支付与账务查询

查订单、账单与交易流水。

风控与核验

做身份、信用与风险信息核验。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 10 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude、VS Code,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好API Key对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在金融服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Ztrade MCP当前 10 未标注 未标注 无 2026-05-17
Alpaca MCP 62 stdio · 本地进程 支持远程部署 有 2026-05-18
OpenNews MCP 11 stdio · 本地进程 支持远程部署 有 2026-05-17
MCP Server 273df76d 未标注 stdio · 本地进程 本地部署 有 2026-05-17
tradingview-mcp 未标注 stdio · 本地进程 本地部署 有 2026-04-19
goat (Goat SDK) 未标注 未标注 未标注 无 2026-05-17

服务器档案

金融服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方ztrade上游标注的维护方 ztrade
分类金融服务本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式API Key远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

13.8 KB
来自项目仓库与上游目录的原文,未做删改

ztrade-mcp

ztrade 量化交易框架的 MCP (Model Context Protocol) Server 实现,使 AI 助手能通过标准化协议调用 ztrade 的核心功能。

功能特性

  • MCP Tools — K线数据管理、策略回测、实盘交易、策略管理、任务管理、Python 研究执行
  • 2 个 Resources — 策略开发文档、Engine API 参考
  • 2 个 Prompts — 策略开发引导、回测分析引导
  • 双传输模式 — stdio(本地 IDE)+ Streamable HTTP(远程 / Docker)
  • 认证控制 — Bearer Token / API Key 两种模式,RBAC 角色权限
  • Docker 支持 — 多阶段构建,一键部署

快速开始

编译```bash

go build -o ztrade-mcp .


### stdio 模式(本地 IDE)```bash
./ztrade-mcp --config /path/to/ztrade.yaml

HTTP 模式(远程访问)```bash

./ztrade-mcp --config /path/to/ztrade.yaml --transport http --listen :8080


### 命令行参数

| 参数 | 默认值 | 说明 |
|------|--------|------|
| `--config` | 自动搜索 | 配置文件路径 |
| `--transport` | `stdio` | 传输模式:`stdio` 或 `http` |
| `--listen` | `:8080` | HTTP 模式监听地址 |
| `--debug` | `false` | 启用调试日志 |

配置文件自动搜索路径:`$HOME/.configs/ztrade.yaml`、`./configs/ztrade.yaml`、可执行文件同级 `configs/ztrade.yaml`。

## MCP Tools

### list_data — 查询本地数据

列出本地数据库中已有的 K 线数据集。

| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| exchange | string | | 过滤交易所 (binance, okx) |
| symbol | string | | 过滤交易对 (BTCUSDT) |

### query_kline — 查询 K 线

从本地数据库查询 OHLCV 数据,供 AI 分析行情。

- 当请求周期大于 `1m` 时,会自动基于 `1m` 数据进行聚合(无需提前存储多周期表)。

| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| exchange | string | ✅ | 交易所名称 |
| symbol | string | ✅ | 交易对 |
| binSize | string | | K 线周期 (1m/5m/15m/1h/1d),默认 1m |
| start | string | ✅ | 开始时间 `2006-01-02 15:04:05` |
| end | string | ✅ | 结束时间 |
| limit | number | | 最大返回条数,默认 500,上限 5000 |

### run_python_research — Python 研究执行(DB 直读)

在独立的 `python-runner` 容器中执行 Python 代码,用于对行情进行研究/建模。

- Scheme B:`python-runner` 直接从数据库读取 K 线数据,避免将大量 OHLCV 通过 HTTP 传回 ztrade-mcp。
- MySQL 场景下 runner 强制使用只读账号(`db.readonly.*` 或 `PYRUNNER_READONLY_*`)。
- Runner 会提供 `df`(pandas.DataFrame,含 `start/open/high/low/close/volume/turnover/trades` 列,额外包含 `time` UTC 时间列)、以及 `pd`/`np`/`load_kline`。
- 镜像基于 Miniconda,内置常见量化库:numpy/pandas/scipy/statsmodels/scikit-learn/ta-lib/ta/empyrical/backtrader/plotly 等。
- 支持图像输出:可在代码中设置 `images` / `image_path` / `image_paths` / `image_base64`,或直接生成 matplotlib 图后不关闭,runner 会自动回传图片。

| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| exchange | string | ✅ | 交易所名称 |
| symbol | string | ✅ | 交易对 |
| binSize | string | | K 线周期,默认 1m |
| start | string | ✅ | 开始时间 `2006-01-02 15:04:05` |
| end | string | ✅ | 结束时间 |
| limit | number | | 加载到 DataFrame 的最大行数;默认 0(由 runner 决定/限制) |
| timeoutSec | number | | 执行超时秒数;默认 0(由 runner 决定) |
| code | string | ✅ | Python 代码(通过 `result = {...}` 返回结果) |

**返回**:文本 JSON(`ok`/`error`/`stdout`/`stderr`/`result`/`meta`)+ 可选 MCP 图片内容(`images`)。文本中仅包含图片元信息,图片本体通过 MCP image content 返回。

### download_kline — 下载 K 线

从交易所下载历史 K 线数据到本地数据库。

| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| exchange | string | ✅ | 交易所名称 |
| symbol | string | ✅ | 交易对 |
| binSize | string | | K 线周期,默认 1m |
| start | string | | 开始时间(auto=false 时必填) |
| end | string | | 结束时间(auto=false 时必填) |
| auto | boolean | | 自动从 DB 最新数据续接下载到当前 |

### run_backtest — 策略回测

使用策略脚本对历史数据进行回测,返回结构化结果。

| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| script | string | ✅ | 策略文件路径 (.go 或 .so) |
| exchange | string | ✅ | 交易所名称 |
| symbol | string | ✅ | 交易对 |
| start | string | ✅ | 回测开始时间 |
| end | string | ✅ | 回测结束时间 |
| balance | number | | 初始资金,默认 100000 |
| fee | number | | 手续费率,默认 0.0005 |
| lever | number | | 杠杆倍数,默认 1 |
| param | string | | 策略参数 JSON |

**返回指标**:总收益率、年化收益率、夏普比率、索提诺比率、最大回撤、胜率、盈亏比、卡玛比率、综合得分等。

### build_strategy — 编译策略

将 Go 策略源码编译为 plugin (.so)。

| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| script | string | ✅ | 策略源文件路径 (.go) |
| output | string | | 输出路径,默认同名 .so |

### create_strategy — 生成策略骨架

根据模板生成策略代码骨架,包含标准的 ztrade 策略接口方法。

| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| name | string | ✅ | 策略名称 (PascalCase,如 EmaGoldenCross) |
| description | string | | 策略描述 |
| outputPath | string | ✅ | 输出文件路径 |
| indicators | string | | 逗号分隔的指标,如 `EMA(9,26),MACD(12,26,9),BOLL(20,2)` |
| periods | string | | 逗号分隔的合并周期,如 `5m,15m,1h` |

### start_trade — 启动实盘

启动实盘交易实例。需要在配置中设置 `mcp.enableLiveTrade: true`。

| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| script | string | ✅ | 策略文件路径 |
| exchange | string | ✅ | 交易所名称 |
| symbol | string | ✅ | 交易对 |
| param | string | | 策略参数 JSON |
| recentDays | number | | 加载最近 N 天历史数据,默认 1 |

### stop_trade — 停止实盘

| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| tradeId | string | ✅ | start_trade 返回的交易实例 ID |

### trade_status — 交易状态

| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| tradeId | string | | 交易实例 ID,不传则返回所有实例 |

## MCP Resources

| URI | 说明 |
|-----|------|
| `ztrade://doc/strategy` | 策略开发指南:策略结构、Param/Init/OnCandle 用法、两种运行方式 |
| `ztrade://doc/engine` | Engine API 参考:交易操作、指标管理、K线合并、内置指标列表 |

## MCP Prompts

| 名称 | 说明 | 参数 |
|------|------|------|
| `create_strategy` | 策略开发引导模板 | strategyType, indicators, timeframe |
| `analyze_backtest` | 回测结果分析引导 | focus (overview/risk/returns/optimization) |

## 认证配置

### stdio 模式 — 无需认证

stdio 模式由本地 IDE 启动进程,天然隔离。

### Bearer Token 模式```yaml
mcp:
auth:
enabled: true
type: token
tokens:
- token: "sk-ztrade-xxxxxxxxxxxxxxxxxxxx"
name: "admin"
role: admin
- token: "sk-ztrade-yyyyyyyyyyyyyyyyyyyy"
name: "readonly-bot"
role: reader

API Key 模式```yaml

mcp:
auth:
enabled: true
type: apikey
header: "X-API-Key"
keys:
- key: "ak-ztrade-xxxxxxxxxxxxxxxxxxxx"
name: "bot-1"
role: trader


### RBAC 角色权限

| 工具 | reader | trader | admin |
|------|:------:|:------:|:-----:|
| list_data | ✅ | ✅ | ✅ |
| query_kline | ✅ | ✅ | ✅ |
| run_python_research | ✅ | ✅ | ✅ |
| download_kline | ❌ | ✅ | ✅ |
| run_backtest | ✅ | ✅ | ✅ |
| build_strategy | ❌ | ✅ | ✅ |
| create_strategy | ✅ | ✅ | ✅ |
| start_trade | ❌ | ✅ | ✅ |
| stop_trade | ❌ | ✅ | ✅ |
| trade_status | ✅ | ✅ | ✅ |

- **reader**:只读操作 + 回测 + 策略生成,不能执行有副作用的操作
- **trader**:reader 的全部权限 + 数据下载、策略编译、交易管理
- **admin**:全部权限

## 配置文件

复用 ztrade 的 `ztrade.yaml` 配置文件,额外支持 `db.readonly`(MySQL 只读账号)与 `pyrunner` 配置:```yaml
# 数据库(MySQL 示例)
db:
type: mysql
uri: root:root_password@tcp(mysql:3306)/exchange?charset=utf8mb4&parseTime=True&loc=Local
readonly:
type: mysql
uri: exchange_readonly:change_me_readonly_password@tcp(mysql:3306)/exchange?charset=utf8mb4&parseTime=True&loc=Local

# 交易所
exchanges:
binance:
type: binance_futures
key: "your-api-key"
secret: "your-api-secret"

# Python 研究执行(python-runner)
pyrunner:
url: "http://python-runner:9000"
token: ""              # 可选;如设置需与 PYRUNNER_TOKEN 一致
clientTimeout: 90s         # ztrade-mcp 调用 runner 的 HTTP 超时

# MCP 专属配置
mcp:
listen: ":8080"
enableLiveTrade: false     # 实盘交易安全开关
auth:
enabled: false
type: token              # token 或 apikey
tokens: []
keys: []

Docker 部署

构建镜像```bash

docker build -t ztrade/ztrade-mcp:latest .


### 使用 docker-compose```bash
docker compose up -d

默认配置:
- 监听 :8080,端点 /mcp
- 配置文件挂载到 /etc/ztrade/ztrade.yaml
- 数据持久化到 ztrade-data volume
- 策略目录挂载为只读
- 健康检查端点 /health

docker-compose.yml 说明```yaml

services:
ztrade-mcp:
build: .
ports:
- "8080:8080"
volumes:
- ./configs/ztrade.yaml:/etc/ztrade/ztrade.yaml:ro
- ztrade-data:/data/ztrade
- ./strategies:/strategies:ro

python-runner:
build: ./python-runner
expose:
- "9000"
volumes:
- ./configs/ztrade.yaml:/etc/ztrade/ztrade.yaml:ro
- ztrade-data:/data/ztrade
environment:
- PYRUNNER_ZTRADE_CONFIG=/etc/ztrade/ztrade.yaml
- PYRUNNER_TOKEN=${PYRUNNER_TOKEN:-}
- PYRUNNER_READONLY_TYPE=${PYRUNNER_READONLY_TYPE:-}
- PYRUNNER_READONLY_URI=${PYRUNNER_READONLY_URI:-}
- PYRUNNER_READONLY_HOST=${PYRUNNER_READONLY_HOST:-}
- PYRUNNER_READONLY_PORT=${PYRUNNER_READONLY_PORT:-}
- PYRUNNER_READONLY_DATABASE=${PYRUNNER_READONLY_DATABASE:-}
- PYRUNNER_READONLY_USER=${PYRUNNER_READONLY_USER:-}
- PYRUNNER_READONLY_PASSWORD=${PYRUNNER_READONLY_PASSWORD:-}

> 说明:Scheme B 下 `python-runner` 需要能访问与 ztrade 相同的 K 线数据库。
> - sqlite:将同一个 DB 文件/volume 挂载到 `python-runner`(示例里复用了 `ztrade-data:/data/ztrade`)。
> - mysql:确保 runner 容器能访问 mysql 网络地址(示例里使用 `mysql` service),并配置 `db.readonly.*`(或 `PYRUNNER_READONLY_*`)以只读账号查询。
> - 首次初始化 MySQL 前,可在 `.env` 设置 `MYSQL_READONLY_USER` / `MYSQL_READONLY_PASSWORD`,`init-readonly.sh` 会按环境变量创建只读账号。

## 客户端配置

### Claude Desktop — stdio```json
{
"mcpServers": {
"ztrade": {
"command": "/path/to/ztrade-mcp",
"args": ["--config", "/path/to/ztrade.yaml"]
}
}
}

VS Code — stdio

.vscode/mcp.json:```json
{
"servers": {
"ztrade": {
"type": "stdio",
"command": "/path/to/ztrade-mcp",
"args": ["--config", "/path/to/ztrade.yaml"]
}
}
}


### VS Code — 远程 HTTP```json
{
"servers": {
"ztrade-remote": {
"type": "http",
"url": "http://your-server:8080/mcp",
"headers": {
"Authorization": "Bearer sk-ztrade-xxxxxxxxxxxxxxxxxxxx"
}
}
}
}

使用场景

AI 辅助策略开发```

用户: 帮我写一个基于 EMA 金叉死叉的策略,快线9慢线26
AI: [create_strategy] → 生成策略骨架
[ztrade://doc/strategy] → 参考文档完善逻辑
[run_backtest] → 回测 BTCUSDT 2024年数据
→ 分析结果:年化收益 15%,最大回撤 8%,夏普比率 1.2


### AI 辅助回测分析```
用户: 回测我的 boll.so 策略
AI:   [list_data] → 确认数据充足
[download_kline] → 补充缺失数据
[run_backtest] → 执行回测
→ 分析结果并给出优化建议

AI 管理实盘交易```

用户: 把 ema_short.so 跑在币安 ETHUSDT 上
AI: [start_trade] → 启动实盘,返回 tradeId
[trade_status] → 监控运行状态
用户: 停掉
AI: [stop_trade] → 停止交易


## 项目结构```
ztrade-mcp/
├── main.go                # 入口:配置加载、DB 初始化、MCP Server 启动
├── go.mod
├── auth/
│   ├── auth.go            # User 模型、Config、RBAC 权限表、Token/APIKey 认证
│   └── middleware.go       # HTTP 认证中间件、ContextFunc、Tool 权限中间件
├── tools/
│   ├── register.go        # 注册全部 Tool
│   ├── list.go            # list_data
│   ├── kline.go           # query_kline
│   ├── download.go        # download_kline
│   ├── backtest.go        # run_backtest
│   ├── build.go           # build_strategy
│   ├── strategy.go        # create_strategy
│   └── trade.go           # start_trade / stop_trade / trade_status
├── resources/
│   ├── register.go        # 注册全部 Resource
│   ├── strategy_doc.go    # ztrade://doc/strategy
│   └── engine_doc.go      # ztrade://doc/engine
├── prompts/
│   ├── register.go        # 注册全部 Prompt
│   ├── strategy.go        # create_strategy prompt
│   └── backtest.go        # analyze_backtest prompt
├── Dockerfile             # 多阶段构建
├── docker-compose.yml     # 一键部署
├── python-runner/        # Python research runner (separate container)
└── .dockerignore

依赖

依赖 说明
mcp-go v0.43.2 MCP 协议 Go SDK
ztrade 量化交易框架核心
ztrade/exchange 交易所接口 (Binance, OKX 等)
ztrade/trademodel 交易数据模型
viper 配置管理
logrus 日志

License

MIT

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Ztrade MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Ztrade MCP 怎么在 Claude Desktop、Claude、VS Code 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Ztrade MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Ztrade MCP 需要 API Key 吗?

资料标注需要API Key认证,使用前准备好对应凭据,并按最小权限配置。

Ztrade MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Ztrade MCP 能提供哪些能力?

资料显示约 10 个工具;能力标签包括 Go、Claude、金融数据。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。