Cryptoconduit Mcp

CryptoConduit MCP

AI エージェントが Polymarket の暗号資産予測市場に、ライブの現物価格を加味して直接アクセスできる MCP サーバー です。自然言語を使って、市場の発見、オーダーブックの分析、戦略のペーパートレード、アクティビティの追跡、ライブ取引の実行ができます。

Rust で構築されています。22 個のツールを備えています。メインネットでテスト済みです。

MCP 互換のクライアントで MCP サーバー として利用するか、core/ ライブラリを独自の Rust ボットやパイプラインに直接インポートできます。MCP への依存はありません。

---

できること

市場インテリジェンス — 6 つのアセット（BTC、ETH、SOL、XRP、DOGE、BNB）と 8 種類の市場（5m から月次まで）にわたる予測市場を発見し、監視します。リアルタイムの Binance 現物価格を Polymarket のオーダーブックに重ねて表示し、取引可能性のスコアリング、スプレッド分析、板の厚みのプロファイリングを行います。

定量分析 — モメンタム、オーダーブックの動向（スプレッドの推移、板の厚みの変化、不均衡）、確率と現物価格の乖離、クジラの資金フローを検出し、市場ごとに 1 つのブリーフィングにまとめます。ローカルの履歴を利用できない場合は、Gamma の解決済み市場を照会し、過去の取引量やアクティビティの状況を補います。

ペーパートレード — Polymarket の手数料モデルに基づく手数料調整済みの損益シミュレーションです。ポートフォリオ全体の追跡、自律的な自動取引の実行、早期決済、ポジション管理に対応したペーパートレードを行えます。実資金を投入する前に、リスクなしで戦略をテストできます。

ライブ取引 — 公式 SDK を通じて、Polymarket で実際の注文を発注・管理します。3 段階の安全ゲートを備えています。デフォルトではドライランであり、明示的な確認が必須で、日次損失上限、ドローダウンの追跡、連続損失時の停止機能を備えたリスクマネージャーもあります。

監視 — 常時稼働するバックグラウンドシステムです。ライブ Polymarket 取引ストリームでのクジラ検出、スプレッド縮小アラート、板の厚みの急増検出、ウィンドウの開始が近づいたことを知らせる通知を行います。手動での設定は不要です。

---

ツール

発見とデータ

ツール	機能
search_crypto_markets	Polymarket の暗号資産予測市場を検索します。アセット、市場の種類（5m、日次、月次など）で絞り込み、スプレッドまたは取引量で並べ替えます。現在の価格、スプレッド、流動性を含むアクティブな市場を返します。
get_active_window	現在の 5m または 15m の予測ウィンドウのスナップショットを取得します。残り時間、現物価格、UP/DOWN 両サイドの最良買値・売値、スプレッド、板の厚みを確認できます。
get_window_briefing	アクティブウィンドウの詳細版です。開始以降の現物価格の変動、1 時間のボラティリティプロファイル、手数料を考慮した損益分岐点の計算、サイドごとの取引可能性のスコアリングを追加します。
get_spot_price	対応する任意のアセットについて、データの経過時間インジケーター付きで Binance の現在の現物価格を取得します。
get_order_book	特定の市場トークンの完全なオーダーブックを取得します。すべての買い・売りレベル、板全体の厚み、注文の集中度分析、さまざまな取引サイズでのスリッページ推定を確認できます。
get_market_analysis	主な分析ツールです。現物価格のモメンタム（1m／5m／15m のトレンド、加速、ボラティリティ）、オーダーブックの動向（スプレッドの推移、板の厚みの非対称性、過去の統計）、確率の乖離（実証モデルと市場価格の比較）、クジラの資金フロー、最近のアラートという 5 つの側面を組み合わせます。ローカルの履歴を利用できない場合は、Gamma の解決済み市場を照会します。5m、15m、日次、月次の市場に対応します。
get_whale_activity	ライブ Polymarket 取引ストリームから、日次および月次市場における最近の大口取引（$5k 以上）を取得します。小規模市場のノイズや決済後の償還は除外します。
get_alerts	バックグラウンドモニターが生成したアラートを取得します。スプレッドの縮小、板の厚みの急増、クジラの取引、満期が近づいているウィンドウが含まれます。

シミュレーションとペーパートレード

ツール	機能
simulate_trade	手数料を考慮した損益計算ツールです。ポジションサイズと価格を入力すると、Polymarket のテイカー手数料、メイカーリベート、決済計算を考慮した、勝ちと負けそれぞれのシナリオでの正確な損益を確認できます。損益分岐点となる勝率も表示します。
paper_trade	現在の市場価格でシミュレーションポジションを開きます。エントリー価格、手数料、タイムスタンプを記録します。Polymarket で市場が解決されると、ポジションは自動的に決済されます。
get_paper_portfolio	ポートフォリオ全体を表示します。ライブカウントダウン付きのオープンポジション、決済済みの結果、資産別およびエントリー価格帯別の勝率、合計損益、手数料の記録を確認できます。
paper_close	現在の買い気配価格でペーパーポジションを早期決済し、決済時のテイカー手数料を支払います。エントリー手数料と決済手数料を含む確定損益を表示します。
set_auto_paper_trade	自動ペーパートレードを設定します。資産、ポジションサイズ、エントリー条件を指定すると、サーバーが市場を監視し、条件を満たしたときに自動でポジションを開きます。
get_auto_paper_trade_status	実行中の自動トレーダー、最近の取引、集計統計を確認します。

ライブトレード

ウォレットの設定が必要です。以下のウォレットのセットアップを参照してください。

ツール	機能
approve_exchange	初回のみ必要なオンチェーン設定です。Polymarket の 3 つの取引所コントラクトで USDC と CTF トークンの送金を承認します。POL のガス代として約 $0.001 かかります。注文を発注する前に実行する必要があります。
get_balance	Polygon 上のウォレットの USDC.e 残高と、リスクマネージャーの状態（1日の損失残額、連続損失、ドローダウン）を表示します。
place_order	買い注文または売り注文を発注します。デフォルトではドライランで、送信せずに実行内容を表示します。実際に実行するには、明示的に confirm=true を指定する必要があります。リスクマネージャーが適用されます。
cancel_order	ID を指定して特定の注文をキャンセルするか、すべてのオープン注文を一度にキャンセルします。
get_positions	ウォレットの現在のライブポジションを表示します。
redeem_winnings	市場の決済後、オンチェーンで勝利した CTF トークンを引き換えます。標準市場と NegRisk 市場の両方で利用できます。

システム

ツール	機能
set_data_logging	現物価格、オーダーブック、市場スナップショットのバックグラウンド JSONL ロギングを切り替えます。データセットの作成やデバッグに便利です。
get_data_logging_status	ロギングが有効かどうか、ファイルの保存場所、現在のディスク使用量を確認します。

---

出力例

ウィンドウのブリーフィング

## BTC 5m Briefing (2:25 AM ET)

Time: 9% elapsed (26s / 300s), 274s remaining
Spot: $70822 -> $70843 (+0.03%)
Volatility (1h): avg 5m move: 0.051% | max: 0.146% | moves >0.05%: 5/12
UP:   ask=0.660 bid=0.650 spread=1.5% | good (depth: $755, slippage $100: 2.0%)
DOWN: ask=0.350 bid=0.340 spread=2.9% | good (depth: $127, slippage $100: 2.3%)
Fees (taker): UP at 0.660: fee=1.3%, breakeven WR=67.3%
              DOWN at 0.350: fee=1.3%, breakeven WR=36.3%

市場分析（日次）

## BTC Market Analysis (daily)

### Spot Momentum
  Price           $70795    Trend        Down
  1m move         -0.085%   5m vol       0.055%
  5m move         -0.039%   Accel        decel (-0.078)
  15m move        -0.167%

$70795 — downtrend, decelerating. High volatility.

### Order Book Dynamics
  ATM strike: $70000 (spot: $70795)

  Side     Spread   Median       Trend    BidDep$    AskDep$  Imbalance
  ------------------------------------------------------------------------
  YES        1.3%     1.3%      stable       $169       $221  Mild ask pressure
  NO         3.9%     3.9%      stable        $74        $59  Mild bid pressure

YES side has better liquidity (tighter spread, deeper book).

### Probability Divergence
  Side     Market  Fair Est.  Divergence           Method       Conf
  --------------------------------------------------------------------
  YES       0.750     0.842   +0.092 (underpriced) vol-CDF      high
  NO        0.260     0.158   -0.102 (overpriced)  vol-CDF      high

YES looks underpriced (+9.2%). NO looks overpriced (-10.2%).

ペーパーポートフォリオ

## Paper Portfolio

Trades: 9 | Wins: 5 | Win rate: 55.6%
Total P&L: $11.66 | Avg P&L: $1.30
Volume: $55.00 | Fees paid: $1.69

By Asset:
  BTC:  4 trades, 50.0% WR, $3.71 P&L
  ETH:  2 trades, 50.0% WR, $3.40 P&L
  SOL:  1 trades, 100.0% WR, $5.04 P&L
  XRP:  1 trades, 100.0% WR, $4.65 P&L

By Entry Price:
  0.30-0.50: 3 trades, 66.7% WR, $9.86 P&L
  0.50-0.70: 6 trades, 50.0% WR, $1.80 P&L

---

要件

• プラットフォーム： Windows、macOS、Linux
• ネットワーク： Polymarket と Binance の API へのアクセスが必要です。

API キーは不要です。 Polymarket と Binance の市場データ API は公開されています。サーバーはすぐに動作し、アカウント登録、サインアップ、トークンは必要ありません。API キーが必要になるのは、ライブトレードを有効にする場合のみです（ウォレットのセットアップを参照）。

クイックスタート

オプション A：ビルド済みバイナリをダウンロード

お使いのプラットフォーム向けの最新バイナリをリリースからダウンロードし、PATH の通った場所に配置してください（または、以下の設定で使うためにフルパスを控えてください）。

オプション B：crates.io からインストール

Rust 1.85 以降が必要です。

cargo install crypto-conduit-mcp

MCP クライアントに接続する

MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "crypto-predict": {
      "command": "crypto-conduit-mcp"
    }
  }
}

バイナリが PATH にない場合は、フルパスを指定してください（例："/path/to/crypto-conduit-mcp" または "C:\\Users\\you\\crypto-conduit-mcp.exe"）。

サーバーは Model Context Protocol を使用して stdio 経由で通信します。

初回起動時： サーバーが Polymarket のすべてのアクティブな市場を検出するまで、約30～45秒かかります。この間、一部のツールで取得できるデータが限られることがあります。最初の検出サイクルが完了すると、すべてのデータが継続的に更新されます。

起動すると、サーバーは次の処理を自動的に行います。

• 4分ごとに新しい市場を検出します
• オーダーブックを取得します（短期市場では5秒ごと、日次／月次市場では30秒ごと）
• Binance の現物価格を3秒ごとに配信します
• Polymarket のライブ取引ストリームを監視し、大口取引を検出します
• アラートを生成します（スプレッドの縮小、板の厚みの急増、時間枠の接近）

これらの処理はすべてバックグラウンドで実行されます。ツールはキャッシュされた状態からデータを読み取るため、すぐに応答します。

設定（任意）

サーバーは設定ファイルなしで動作します。設定をカスタマイズするには、プラットフォームに応じた場所に設定ファイルを作成します。

• Windows： %APPDATA%\crypto-conduit\config.toml
• macOS： ~/Library/Application Support/crypto-conduit/config.toml
• Linux： ~/.config/crypto-conduit/config.toml

[logging]
enabled = false          # background data logging (JSONL files)

# [trading]              # uncomment for live trading — see Wallet Setup below
# private_key = "..."
# max_order_size_usd = 100

---

ウォレットの設定（ライブ取引）

ライブ取引には、ウォレットの設定が必要です。ペーパートレードには、これらの設定は必要ありません。

1. EOA ウォレットを作成するか、既存のウォレットを使用する

Polygon 上の外部所有アカウント（EOA）が必要です。MetaMask ウォレット、取引専用ウォレット、または Ethereum 互換のウォレットを使用できます。メインのウォレットは使用しないでください。取引用の専用ウォレットを作成してください。

2. ウォレットに資金を入金する

• Polygon 上の USDC.e（ブリッジされた USDC）。これは Polymarket が使用する担保トークンです。コントラクト：0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174。ネイティブ USDC（0x3c499...）ではありません。
• ガス代として少額の POL（オンチェーンでの承認にかかる費用は約 $0.001）。

3. 秘密鍵を設定ファイルに追加する

[trading]
private_key = "abc123..."   # 64 hex characters, no 0x prefix
wallet_type = "eoa"
max_order_size_usd = 100    # safety cap per order
daily_loss_limit_usd = 50   # risk manager halts trading if exceeded

セキュリティ： 秘密鍵がログに記録されることはありません。サーバーでは Debug 出力を秘匿する実装を使用しています。それでも、この設定ファイルにはアクセス制限を設定してください。

4. 取引所コントラクトを承認する

最初の注文を出す前に、approve_exchange ツールを実行してください。これは、Polymarket の3つの取引所コントラクト（CTF Exchange、Neg Risk CTF Exchange、Neg Risk Adapter）に対して、USDC と CTF トークンの送金を承認する一度限りのオンチェーン取引です。

5. 注文を出す

すべての注文はデフォルトでドライランモードになっており、実際には送信せず、注文を出した場合の結果を表示します。実際の注文を実行するには、confirm=true を設定します。リスクマネージャーは注文の前に毎回、1日の損失上限、連続損失、ドローダウンを確認します。

---

プロンプトの例

MCP 経由で接続したら、AI エージェントで次のプロンプトを試してください。

市場の発見と分析

• 「アクティブな BTC 日次市場を教えてください。スプレッドが狭い順に並べてください」
• 「現在の ETH 5m の時間枠について概要を教えてください」
• 「BTC 日次市場の完全な市場分析を実行してください」
• 「BTC $70k の権利行使価格のオーダーブックを表示してください」

シミュレーション

• 「BTC 日次の YES を0.75で$50分購入した場合、勝ちと負けそれぞれの損益はいくらですか？」
• 「0.65でエントリーする場合、損益分岐点に達するには何％の勝率が必要ですか？」

ペーパートレード

• 「BTC 5m UP を$10分ペーパートレードしてください」
• 「ペーパーポートフォリオを表示してください。決済済みのポジションはありますか？」
• 「ポジション #3 をクローズしてください」
• 「ETH 5m の自動ペーパートレードを設定してください。サイズは$5、0.45未満でエントリーし、現物価格が0.1%+動いた場合のみ実行してください」

ライブ取引

• 「ウォレット残高とリスク状況を確認してください」
• 「ドライラン：ETH 日次の YES を0.52で$10分購入してください」
• 「未約定の注文をすべてキャンセルしてください」

監視

• 「過去30分間に大口取引やアラートはありましたか？」
• 「すべての資産の最近の大口取引を表示してください」

---

Rust ライブラリとして使用する

core/ モジュールは MCP に依存しない、単独で使えるライブラリです。カスタムボット、データパイプライン、または別のインターフェースで直接インポートして使用できます。

use crypto_conduit::core::providers::binance;
use crypto_conduit::core::analysis::fees;
use crypto_conduit::core::paper::portfolio;

Supported assets

Asset	Binance Pair	5m	15m	Hourly	Daily	Monthly
BTC	BTCUSDT	Yes	Yes	Yes	Yes	Yes
ETH	ETHUSDT	Yes	Yes	Yes	Yes	Yes
SOL	SOLUSDT	Yes	Yes	Yes	Yes	Yes
XRP	XRPUSDT	Yes	Yes	Yes	Yes	Yes
DOGE	DOGEUSDT	Yes	Yes	Yes	Yes	Yes
BNB	BNBUSDT	Yes	Yes	Yes	Yes	No

Architecture

src/
├── main.rs              ← MCP server entry point
├── mcp/                 ← MCP tool layer (thin wrappers)
│   ├── mod.rs           ← Tool registration
│   ├── tools_*.rs       ← Tool handlers by category
│   └── formatter.rs     ← Response formatting
└── core/                ← Standalone library (no MCP dependency)
    ├── types.rs          ← Shared types
    ├── providers/        ← API clients (Polymarket, Binance, Chainlink)
    ├── analysis/         ← Fee model, momentum, book dynamics, divergence
    ├── paper/            ← Paper trading engine
    ├── execution/        ← Live trading (Polymarket SDK, risk manager)
    └── monitor/          ← Background polling, alerts, whale tracking, auto-trade

License

AGPL-3.0 — see LICENSE for details.