The Spice Melange Trading Desk: DeepBook market data connector

The Spice Melange Trading Desk：DeepBook マーケットデータコネクター

AI エージェント向けの読み取り専用 DeepBook v3 マーケットデータです。（パッケージ、サーバー ID、エンドポイントでは plumbline という名前を使用します。）

The Spice Melange Trading Desk（DeepBook マーケットデータコネクター、パッケージ plumbline-mcp）は、Sui DeepBook v3 のマーケットデータを提供する無料の読み取り専用Model Context Protocol サーバーです。エージェントに、プール、ミッド価格とスプレッド、注文板の厚み、取引高、オンチェーン手数料のリアルタイム情報、最近の取引、OHLCV ローソク足を提供します。

• API キー、ウォレット、署名、取引は不要です。 すべてのツールに readOnlyHint: true の注釈が付いています。
• 出力はコンパクトです。 系列データには列／行配列を使ったコンパクトな JSON を返し、適切に丸めます。
• 高速で負荷に配慮しています。 インメモリ TTL キャッシュ（板情報は 2 秒、メタデータは最大 10 分）、重複リクエストの排除、8 秒のタイムアウトを備えています。

免責事項：教育および情報提供のみを目的としています。金融、投資、法律、税務に関する助言ではありません。 データは公開されているサードパーティの情報源（Mysten Labs DeepBook インデクサーおよび Sui GraphQL）から取得されます。遅延、不完全、または誤りがある場合があり、保証なしに「現状のまま」提供されます。ここに記載された内容は、いかなる資産の購入、売却、保有も推奨するものではありません。

クイックスタート

npx -y plumbline-mcp

サーバーは stdio で動作し、Node.js 18.17 以降が必要です。設定は不要です。

Claude Code

claude mcp add plumbline -- npx -y plumbline-mcp

Claude Desktop、Cursor、Windsurf、VS Code、またはその他の stdio クライアント

クライアントの MCP 設定（claude_desktop_config.json、~/.cursor/mcp.json など）に次を追加します。

{
  "mcpServers": {
    "plumbline": {
      "command": "npx",
      "args": ["-y", "plumbline-mcp"]
    }
  }
}

Smithery

npx -y @smithery/cli@latest mcp add nazarenechalice/plumbline --client claude   # or cursor, claude-code, vscode, windsurf, ...

Smithery の掲載ページを開くこともできます。Claude Desktop にワンクリックでインストールするには、そこで .mcpb バンドルをダウンロードしてください。

ホスト型エンドポイント（リモート、インストール不要）

ホスト型インスタンスは https://plumbline-mcp.fly.dev/mcp で動作します（ストリーミング可能な HTTP、ステートレス、JSON レスポンス。ヘルスチェックは /health、サーバーカードは /.well-known/mcp/server-card.json）。

claude mcp add --transport http plumbline https://plumbline-mcp.fly.dev/mcp

リモート MCP URL を指定できるクライアント（Cursor、VS Code、Claude Desktop コネクター、Windsurf）で利用できます。

{
  "mcpServers": {
    "plumbline": { "type": "http", "url": "https://plumbline-mcp.fly.dev/mcp" }
  }
}

ホスト型エンドポイントでは、各クライアントに UTC の 1 日ごとに無料のツール呼び出し 100 回が提供され、その後は1 回につき 0.002 USDCが必要です。Sui メインネット上で USDC を約 0.01 USDC ずつ前払いします。get_indexer_status は常に無料です。無料枠を使い切ると、ツールは正確な金額と非公開の payment_token を含む x402 形式の支払い必須結果を返します。詳しくはdocs/PAYMENTS.mdを参照してください。npm／stdio パッケージは無料で、利用制限もありません。

ストリーミング可能な HTTP（セルフホスト）

npx -y plumbline-mcp --http --port 8081        # POST http://127.0.0.1:8081/mcp, GET /health
HOST=0.0.0.0 PORT=8081 npx -y plumbline-mcp --http

HTTP モードはステートレスで、JSON を返します。また、/.well-known/mcp/server-card.json で静的なサーバーカードを提供し、各クライアントのリクエストを 1 分あたり 120 件に制限します。外部に公開する前に TLS の背後に配置してください。ホスティングに関する注意事項はdeploy/DEPLOY.mdを参照してください。

エージェントへの質問例

• 「現在の DeepBook SUI_USDC のスプレッドはいくつですか？」
• 「SUI_USDC のミッド価格から 1% 以内の流動性はどれくらいですか？」
• 「過去 1 日分の DEEP_USDC の 1 時間足ローソクを表示してください。」
• 「過去 24 時間で最も取引高が多かった DeepBook のプールはどれですか？」
• 「SUI_USDC の現在のテイカー手数料とメイカー手数料はいくらですか？」

サーバーには、プロンプト（market_snapshot、compare_pools、liquidity_check）とリソース（plumbline://guide、plumbline://disclaimer）も含まれています。

ツール

ツール	返される内容	主な入力
list_pools	すべてのDeepBookプール：ベース／クオート、ティック、ロット、最小サイズ、アクティブフラグ	asset?（例：SUI）、include_ids?
get_mid_price	最良の買値／売値、ミッド価格、スプレッド（絶対値とbps）、最終価格	pool
get_order_book	各サイドの上位N段階、およびミッド価格の±X％以内のベース数量とクオート建て想定元本	pool、levels（1-100）、within_pct（例：[0.5,1,2]）
get_volume	24時間のベース／クオート出来高、高値／安値、変化率、VWAP。または出来高上位のプール、またはカスタムの直近期間	pool?、window_hours（1-720）、top
get_pool_params	テイカー／メーカー手数料（％とbps）、必要なDEEPステーク、ティック／ロット／最小値、ホワイトリスト／ステーブルフラグ、ボールト残高（オンチェーンのライブデータ）	pool
get_recent_trades	最新の約定：時刻、テイカー側、価格、ベースとクオートの数量、買い／売り統計	pool、limit（1-200）、start_time?、end_time?（Unix秒）、include_tx?
get_ohlcv	古い順のローソク足。出来高はベース資産建て	pool、interval（1m,5m,15m,30m,1h,4h,1d,1w）、limit（1-500）、start_time?、end_time?
get_indexer_status	データソースの健全性と鮮度	なし
get_bm_fills	1つのBalanceManagerがメーカー（またはテイカー）だった約定：時刻、その側、価格、数量、手数料と手数料トークン、トランザクション	pool、balance_manager_id、role?、limit、hours
get_swing_range	1時間／4時間／24時間のレンジ、実現ボラティリティ、レジーム（4時間レンジがCALM < 2%、ELEVATED 2-4%、HIGH_VOL > 4%）、推奨ラング数3/4/5	pool
get_pool_stats	N時間のスコアカード形式の統計：取引数、テイカーの買い／売り内訳、出来高、VWAP、平均取引、レンジ、スプレッド	pool、hours（1-72）
estimate_fees	入力トークンで支払う約定手数料（レート×1.25）とDEEPで支払う場合（基本レート）。ライブのオンチェーンレートに基づきます	pool、qty、price?、role

プール名はBASE_QUOTE形式です（例：SUI_USDC）。入力では大文字と小文字が区別されず、sui/usdcやSUI-USDCも使用できます。不明なプールを指定すると、候補を含む明確なエラーが返されます。たとえばUSDC_SUIを指定すると、SUI_USDCが候補として示されます。

出力例（ライブデータ、2026年10月9日）

get_mid_priceに{"pool":"SUI_USDC"}を指定：

{"pool":"SUI_USDC","quote":"USDC","best_bid":1.0708,"best_ask":1.07106,"mid":1.07093,"spread":0.00026,"spread_bps":2.428,"last_price":1.0708,"as_of":"2026-10-09T08:38:03.997Z"}

get_order_bookの1つの深度帯（同日の以前のスナップショット）：

{"pct":1,"bid_base":204536.4,"bid_quote":216152.61,"ask_base":105721.5,"ask_quote":113063.72,"bid_levels":26,"ask_levels":27}

get_pool_paramsに{"pool":"SUI_USDC"}を指定（オンチェーンのPoolオブジェクトからライブデータを読み取り。抜粋）：

{"pool":"SUI_USDC","source":"sui-onchain","taker_fee":{"pct":0.02,"bps":2},"maker_fee":{"pct":0,"bps":0},"stake_required_deep":100000,"tick":0.00001,"lot":0.1,"min_size":1}

get_ohlcvに{"pool":"SUI_USDC","interval":"1h","limit":2}を指定：

{"pool":"SUI_USDC","interval":"1h","count":2,"cols":["open_time","open","high","low","close","volume_SUI"],"candles":[["2026-10-09T07:00:00Z",1.0658,1.07579,1.06268,1.07543,66001],["2026-10-09T08:00:00Z",1.07529,1.07817,1.06721,1.0708,26347.5]]}

設定（すべて任意）

環境変数	デフォルト
PLUMBLINE_INDEXER_URL	https://deepbook-indexer.mainnet.mystenlabs.com
PLUMBLINE_GRAPHQL_URL	https://graphql.mainnet.sui.io/graphql
PLUMBLINE_TIMEOUT_MS	8000
PORT / HOST（HTTPモード）	8081 / 127.0.0.1

比較

Plumblineはデータを読み取るだけです。DeepBook向けのトレーディングMCPはトランザクションを構築し、キーを保持する場合があります。幅広いSui分析MCPは、多くのプロトコルを対象とします。PlumblineはDeepBookの市場データを深く掘り下げ、ミッド価格周辺の深度帯、オンチェーンのライブ手数料、OHLCV、プール名の候補を提供します。資金にリスクを及ぼすことなく、どのエージェントにも利用させることができます。

データソース：板、取引、出来高、ローソク足は、公開DeepBookインデクサーから取得します。手数料とプールパラメーターは、Sui GraphQL経由でライブのPoolオブジェクトから取得します。

オプション：従量課金（デフォルトでは無効）

stdioパッケージは常に無料です。ホスト型エンドポイントでは呼び出し回数を計測します（1日あたり100回まで無料、その後は1回につき0.002 USDC）。セルフホストのHTTP運用者も、たとえば1日あたり100回まで無料、その後は1回につき0.002 USDCをSui上のUSDCで支払う形で、呼び出し回数を計測できます。PLUMBLINE_PAYMENTS=1を設定しない限り、計測は無効です。サーバーは受信専用で、キーを保持することはありません。設計とセキュリティモデルの詳細はdocs/PAYMENTS.mdをご覧ください。

ソースからビルド

git clone https://github.com/SajanMelcher/plumbline-mcp.git
cd plumbline-mcp
npm install && npm run build
node dist/index.js            # stdio; add --http for HTTP

開発

npm test            # live tests against the public indexer (SUI_USDC); needs network
npm run smoke       # spawns the server over stdio and calls every tool via the MCP client
npm run smoke:http  # same over streamable HTTP
npm run inspector   # MCP Inspector UI
npm run payments:testnet  # Sui testnet end-to-end with a throwaway payer (needs testnet SUI + USDC)
npm run pack:mcpb   # MCPB bundle at build/plumbline.mcpb, validated with mcpb + a Smithery payload check (publishes nothing)

注記と制限

• 公開インデクサーが提供する価格レベルは、片側につき最大で約 100 件です。深度帯がそれを超える場合、レスポンスでは truncated: true と示され、値は下限値になります。
• list_pools のパラメーターはインデクサーのメタデータに基づきます。get_pool_params はオンチェーンの Pool オブジェクトを直接読み取るため、ガバナンスによってティックサイズや手数料が変更された場合の正式な情報源となります。
• 手数料は DeepBook の固定小数点値（スケールは 1e9）で、パーセントおよび bps に変換されます。
• マージン、バランスマネージャー、ウォレット固有のエンドポイントは公開されていません。

名前の由来と独立性

Plumbline は、深さと真の垂直を測るために使う、おもり付きのひもである下げ振りにちなんで名付けられました。他の候補には Sounding と Tidemark がありました。Plumbline は独立したコミュニティプロジェクトです。Mysten Labs、Sui Foundation、DeepBook とは提携していません。

ライセンス

MIT です。LICENSE をご覧ください。

ストアおよびデスクツール（v0.3.3）

エージェントが人間によるチェックアウトなしで、テンプレートを探し、購入し、参加するためのツールが 4 つ追加されています。無料で利用でき、使用量に応じた課金はありません。

ツール	機能
list_templates	テンプレート、Sui USDC 建ての価格、ライセンス、購入手順を表示します（thespicemelange.org/store/catalog.json から取得）。
create_template_order	ストアの注文を作成し、支払先、正確な金額、非公開の注文トークンを返します。課金は発生しません。クライアントごとに 1 時間あたり数件までです。
check_template_order	支払いダイジェストを指定すると、オンチェーンで支払いを検証し、ダウンロードリンクを返します。指定しない場合は、注文状況を返します。
get_desk_rhythm	デスクの週間リズムを返し、固定されたリリースキーに照らして ed25519 署名を検証します。検証に失敗すると、呼び出しも失敗します。あくまで参考情報です。

支払いはご自身のウォレットから行います。コネクターがキーや資金を保持することはありません。注文トークンはヘッダーに含めて https://thespicemelange.org（固定先）にのみ送信され、保存されることはありません。すべての販売は最終的なものです。金融上の助言ではありません。

ストアツールの安全性に関する詳細：

• 固定されたストア： 接続先は https://thespicemelange.org のみです。プレビュー用ストアを使用するには、テスト目的に限り、PLUMBLINE_STORE_URL と PLUMBLINE_ALLOW_PREVIEW_STORE=1 の両方が必要です。
• 支払先の確認： create_template_order は、固定されたリリースキーに照らして検証した署名付きの templates/versions.json を読み取ります。そこに公開されている支払先、またはコネクター自身が固定している支払先と異なる注文は拒否します。支払先が未公開の場合、応答では payeeVerified: false と示されます。支払いの前に、完全なアドレスを所有者に提示し、明示的な承認を得てください。

注文制限（ホスト型）。 各クライアント（IPv4 アドレス、または IPv6 /48）につき、1 時間あたり新規注文は 3 件まで、未払いの注文は同時に最大 2 件までです。サーバー全体では、1 時間あたり 60 件まで、未払いの注文は 15 件までです。これらのカウンターはメモリ内に保持され、サーバーの再起動時にリセットされます。ストア側でも、KV に永続化される独自の時間あたり制限を適用します。ホスト型コネクターはストアキーとハッシュ化したクライアント ID（IP アドレスは送信しません）を送信するため、ストアはコネクターの共有 IP を 1 つのクライアントとして扱うのではなく、転送されたクライアントごとに制限を適用します。未払いの注文は、ストアの 30 分間の支払い猶予期間が過ぎると期限切れになります。