deribit-mcp

把 Deribit 接进你的 AI 助手。支持 Claude Code、Codex 等任意 MCP 客户端， 一条命令接入，让助手能查行情、看账户、管订单。

claude mcp add deribit -- npx -y deribit-mcp

装完就能问："BTC 现在的期权链什么样？"、"帮我看看 3 月到期的看涨期权隐含波动率"、 "我账户里还有多少可用保证金？"

两道安全默认值：默认连测试网，默认关闭交易。要下真单必须两处都显式打开。

安装

Claude Code

只看行情，不需要任何配置：

claude mcp add deribit -- npx -y deribit-mcp

要查账户和订单，加上 API 凭据并切到主网：

claude mcp add deribit \
  --env DERIBIT_ENV=prod \
  --env DERIBIT_CLIENT_ID=你的_client_id \
  --env DERIBIT_CLIENT_SECRET=你的_client_secret \
  -- npx -y deribit-mcp

Codex

编辑 ~/.codex/config.toml（或项目里的 .codex/config.toml）：

[mcp_servers.deribit]
command = "npx"
args = ["-y", "deribit-mcp"]

[mcp_servers.deribit.env]
DERIBIT_ENV = "prod"
DERIBIT_CLIENT_ID = "你的_client_id"
DERIBIT_CLIENT_SECRET = "你的_client_secret"

其它 MCP 客户端

任何支持 stdio 的客户端都能用，命令是 npx -y deribit-mcp，配置通过环境变量传。

从源码运行（可选）

想固定到某个版本、或者自己改过代码，可以直接指向源码，不用每次改完记得重新构建：

git clone https://github.com/freeeverett/deribit-mcp.git
cd deribit-mcp && npm install

[mcp_servers.deribit]
command = "npx"
args = ["tsx", "/绝对路径/deribit-mcp/src/index.ts"]

代价是启动慢一倍左右（约 160ms vs 77ms），且需要本地装好依赖。 日常使用推荐还是走 npx -y deribit-mcp。

获取 API 凭据

在 Deribit 账户设置 → API 创建 key。

建议按最小权限来：只想让助手帮你分析的话，给 trade:read 就够了， 这样即使误开了交易开关也下不了单。

Related MCP server: Crypto Options Desk MCP

配置项

测试网是独立的：test.deribit.com 的账号和 API key 与主网完全不通用， 需要在 test.deribit.com 单独注册。测试网可以免费领测试币， 适合先跑通流程再切主网。

全量测试网集成测试

在项目根目录创建已被 git 忽略的 .env.test，只放测试网 API 凭据：

DERIBIT_CLIENT_ID=你的测试网_client_id
DERIBIT_CLIENT_SECRET=你的测试网_client_secret

然后运行：

npm run test:all

该入口会原生读取 .env.test，并强制连接测试网（不会采用文件中的主网或自定义端点设置）。 它通过真实 stdio MCP 客户端执行全部 39 个工具，要求 key 具有 trade:read_write：会创建、修改并撤销 带唯一测试标签的限价单，短暂市价开平仓，并创建一个测试组合。脚本退出时会按该标签兜底撤单；若清理失败， 命令会以失败退出。现有 npm run smoke 仍是不需要凭据的快速公开接口回归。

关于交易功能

下单相关的工具默认不开放——不填 DERIBIT_ENABLE_TRADING=true 的话， 你的助手根本看不到这些工具，也就无从误触。

打开之后可用：下单、改单、撤单、平仓、创建组合合约。

请务必知道：

• 这些操作会在你的真实账户上产生真实成交，钱是真的

• 建议先在测试网跑熟流程，再考虑主网

• 主网 + 开启交易时，服务启动会打出显式警告，助手也会收到"执行前必须与用户确认"的指示

• 但最终的闸门是你自己：任何下单请求出现时，先看清楚再点同意

如果你只想让助手做分析、不想让它碰订单，就别开这个开关——行情和账户查询完全不受影响。

能做什么

共 39 个工具。

行情（18 个，无需凭据）

合约与币种列表、合约规格、到期日、期权链（持仓量 / 隐含波动率 / 买卖价）、 实时行情与盘口深度、期权 Greeks、历史 K 线、标记价格历史、指数现价与历史、 历史已实现波动率、DVOL 波动率指数、永续资金费率、全市场成交、交易所成交量、 生息代币 APR、交割价、结算与穿仓记录、组合合约、平台状态、交易所公告。

账户与订单（16 个，需要凭据）

账户权益与保证金、全币种概览与账户锁、持仓明细、子账户列表、组合保证金模拟、 资金流水、结算与交割记录、充提划转流水、当前挂单、订单状态、历史订单、 触发单历史、成交明细、单笔订单成交、下单保证金估算。

交易（5 个，需要凭据且显式开启）

下单（限价 / 市价 / 止损 / 止盈 / 移动止损 / 冰山 / 期权高级定价）、 改单、撤单、平仓、创建多腿组合合约。

完整的工具与接口对应关系见 docs/API-COVERAGE.md。

版本号怎么看

版本号形如 2.20260721.0：

• 2 — Deribit API 大版本（v2）

• 20260721 — 对齐到的 Deribit 官方文档发布日期（2026-07-21）

• 0 — 该文档版本下的第几次修订

也就是说，看中间那段就知道这个版本跟的是哪天的 Deribit 文档。 Deribit 更新接口后，本项目会跟着把中间那段推到新日期。

常见问题

助手说找不到 Deribit 工具？ 检查客户端的 MCP 日志。服务启动时会往 stderr 打出当前环境、凭据状态和注册的工具数量， 一眼能看出是配置没生效还是别的问题。

只看得到行情工具，账户工具都不见了？ 说明凭据没读到。确认 DERIBIT_CLIENT_ID 和 DERIBIT_CLIENT_SECRET 两个都配了—— 只配一个的话服务会直接启动失败并说明缺哪个。

看不到下单工具？ 需要 DERIBIT_ENABLE_TRADING=true，且凭据已配置。这是刻意的默认行为。

报错 invalid_credentials？ key 或 secret 不对，或者填的是测试网的 key 却连了主网（反之亦然）。两边账号不通用。

报错说 scope 不足？ API key 没有 trade:read_write 权限。服务会在下单之前就报错， 而不是让你误以为单已经发出去了。去 Deribit 后台给 key 加权限，或者关掉交易开关。

改了配置没生效？ MCP 服务在客户端启动时拉起，改完环境变量需要重启客户端。

License

MIT