deribit-mcp

Deribit をあなたの AI アシスタントに接続します。Claude Code、Codex などあらゆる MCP クライアントに対応し、ワンコマンドで接続。アシスタントが相場の確認、口座の閲覧、注文管理をできるようにします。

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

インストールが終われば、「BTCの現在のオプションチェーンは？」「3月満期のコールオプションのインプライド・ボラティリティを見せて」「私の口座の余力はいくら？」と聞くだけでOKです。

2つの安全デフォルト: デフォルトでテストネットに接続し、デフォルトで取引は無効です。本番注文を出すには、両方とも明示的にオンにする必要があります。

インストール

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"]

欠点は、起動が約2倍遅くなること（約160ms対77ms）と、ローカルに依存関係がインストールされている必要があることです。日常的な利用では、やはり npx -y deribit-mcp をお勧めします。

API 認証情報を取得する

Deribit アカウント設定 → API でキーを作成します。

最小権限を推奨します：アシスタントに分析だけさせたい場合は、trade:read を付与すれば十分です。そうすれば、誤って取引スイッチをオンにしても注文はできません。

Related MCP server: Crypto Options Desk MCP

設定項目

テストネットは独立しています：test.deribit.com のアカウントと API キーはメインネットとは一切互換性がなく、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 ツールを実行し、キーに trade:read_write が必要です。一意のテストタグを付けた指値注文を作成・変更・キャンセルし、短時間の成行注文でポジションを開閉し、テスト複合注文を作成します。スクリプト終了時にはそのタグで注文を確実にキャンセルします。クリーンアップに失敗した場合は、コマンドは失敗ステータスで終了します。既存の npm run smoke は、認証情報を必要としない高速な公開インターフェースのリグレッションテストとして引き続き利用できます。

取引機能について

注文関連のツールはデフォルトでは無効です。DERIBIT_ENABLE_TRADING=true を設定しない限り、アシスタントはこれらのツールを一切認識できないため、誤操作の心配もありません。

有効にすると利用可能：注文、注文変更、キャンセル、決済、複合注文の作成。

必ずご理解ください：

• これらの操作は実際の口座で実際の約定を発生させます。お金は本物です

• まずテストネットでフローに慣れてから、メインネットを検討することをお勧めします

• メインネット + 取引有効時は、サービス起動時に明示的な警告が表示され、アシスタントにも「実行前にユーザーに確認すること」という指示が渡されます

• しかし最終的なゲートはあなた自身です：注文リクエストが来たら、よく確認してから承認をクリックしてください

アシスタントに分析だけさせて注文を触らせたくない場合は、このスイッチをオンにしないでください。相場と口座照会にはまったく影響しません。

できること

全 39 ツール。

相場（18個、認証情報不要）

銘柄と通貨リスト、銘柄仕様、満期日、オプションチェーン（建玉・インプライド・ボラティリティ・売買気配）、リアルタイム相場と板の厚み、オプションのグリークス、過去のローソク足、マーク価格の履歴、指数の現在値と履歴、過去の実現ボラティリティ、DVOL ボラティリティ指数、無期限先物の資金調達レート、全市場の出来高、取引所の取引量、利付きトークンのAPR、決済価格、清算・強制決済履歴、複合注文、プラットフォームステータス、取引所のお知らせ。

口座と注文（16個、認証情報が必要）

口座の純資産と証拠金、全通貨の概要と口座ロック、ポジション明細、サブアカウント一覧、ポートフォリオ証拠金シミュレーション、入出金履歴、決済・受渡履歴、振替履歴、現在の注文、注文ステータス、注文履歴、トリガー注文履歴、約定明細、注文ごとの約定、注文証拠金の見積もり。

取引（5個、認証情報と明示的な有効化が必要）

注文（指値・成行・逆指値・利益確定・トレーリングストップ・アイスバーグ・オプション高度な価格設定）、注文変更、キャンセル、決済、複数レッグの複合注文の作成。

完全なツールと API の対応表は docs/API-COVERAGE.md を参照してください。

バージョン番号の見方

バージョン番号は 2.20260721.0 のような形式です：

• 2 — Deribit API のメジャーバージョン（v2）

• 20260721 — 対応する Deribit 公式ドキュメントの公開日（2026-07-21）

• 0 — そのドキュメントバージョンでのリビジョン番号

つまり、中央の部分を見れば、そのバージョンがどの日の Deribit ドキュメントに対応しているかがわかります。Deribit が API を更新すると、このプロジェクトも中央の部分を新しい日付に更新します。

よくある質問

アシスタントが Deribit ツールが見つからないと言う場合？ クライアントの MCP ログを確認してください。サービス起動時に現在の環境、認証情報の状態、登録済みツールの数が stderr に出力されるので、設定が反映されていないのか、それとも別の問題なのかが一目でわかります。

相場ツールしか見えず、口座ツールがすべて表示されない場合？ 認証情報が読み込まれていません。DERIBIT_CLIENT_ID と DERIBIT_CLIENT_SECRET の両方が設定されているか確認してください。片方だけの場合、サービスは起動に失敗し、どちらが不足しているかが表示されます。

注文ツールが表示されない場合？ DERIBIT_ENABLE_TRADING=true と、認証情報の設定が必要です。これは意図的なデフォルト動作です。

invalid_credentials エラーが発生する場合？ キーまたはシークレットが正しくないか、テストネットのキーをメインネットに接続しようとしています（その逆も同様）。両者のアカウントは互換性がありません。

スコープが不足しているというエラーが発生する場合？ API キーに trade:read_write 権限がありません。サービスは注文を出す前にエラーを返すので、注文が送信されたと誤解することはありません。Deribit の管理画面でキーに権限を追加するか、取引スイッチをオフにしてください。

設定を変更しても反映されない場合？ MCP サービスはクライアントの起動時に起動されるため、環境変数を変更したらクライアントを再起動する必要があります。

ライセンス

MIT