Lucyd

Lucyd MCP サーバー

AI エージェント（Claude、Cursor、または任意の MCP クライアント）を、予測市場取引所の Lucyd に接続します。平易な言葉で、マーケットの閲覧、オーダーブックの確認、取引、ポジションの決済、利益の受け取りを依頼できます。

Lucyd は現在、テスト用 USDC を使って Ethereum Sepolia テストネット上で稼働しています。

できること

ツール	機能
list_markets	状態と期間で絞り込んだマーケットの一覧
get_market	1つのマーケットのルール、権利行使価格、終了日、結果トークン ID
get_order_book	結果の買い注文と売り注文、最良買い気配、最良売り気配、中間価格
list_trades	マーケット別またはトレーダー別の最近の取引
get_positions	保有トークン、平均価格、価値、利益
get_trader_stats	ウォレットの利益、取引高、勝率
get_pnl_history	時系列の利益
top_traders	ランキング
get_status	サービス、決済、リアルタイム取引が正常かどうか
get_wallet	あなたのアドレス、ETH と USDC の残高、承認状況
get_open_orders	あなたの未約定注文
get_order_history	ステータスと約定状況を含む、過去および現在の注文
place_order	指値または成行注文（上昇または下降の買い・売り）
close_position	マーケットで保有するすべてのポジションをすぐに売却
cancel_orders	ID、マーケット内のすべて、またはすべての注文をキャンセル
approve_trading	Exchange コントラクトの初回承認
set_auto_redeem	利益の自動受け取りを有効または無効にする
redeem	決着済みマーケットの払い戻しを受け取る

リクエストの例：

• 「現在オープンしている1時間マーケットと、現在のマーケットのオーダーブックを表示して」
• 「現在の15分マーケットで、0.55以下で上昇トークンを10個買って」
• 「5分マーケットのポジションを決済して」
• 「今週のポジションと合計利益を教えて」
• 「すべての注文をキャンセルして」

ウォレットキーがない場合、サーバーは読み取り専用で動作します。マーケット、オーダーブック、取引、および任意のウォレットの公開統計を確認できます。

ホスト型、読み取り専用

マーケットデータのみを利用する場合は、インストールは不要です。Streamable HTTP に対応する Claude、ChatGPT、または任意のクライアントで、カスタムコネクター（認証なしのリモート MCP サーバー）として https://mcp.lucyd.trade/mcp を追加してください。利用できるのはマーケットデータのツールです。マーケット、オーダーブック、取引、および任意のウォレットアドレスのポジションと統計を確認できます。取引には自分のウォレットキーが必要なため、以下のローカルサーバーでのみ利用できます。

独自のホスト型コピーを実行するには、LUCYD_HTTP_ADDR（例：0.0.0.0:3006）と LUCYD_HTTP_HOSTS（応答するホスト名）を設定します。すると、サーバーは /mcp で MCP を提供し、ウォレットキーがある場合は起動を拒否します。

インストール

最も簡単な方法では、Node.js 18 以降だけが必要です。クライアントは npx -y @lucyd/mcp を実行し、初回実行時に使用システム用のバイナリをダウンロードして SHA-256 を検証します。ほかにインストールするものはありません。以下の設定を参照してください。

Node.js を使わない場合は、data.testnet.lucyd.trade/mcp から使用システム用のバイナリをダウンロードし（最新バージョンのフォルダーを開いてください。SHA256SUMS にチェックサムが記載されています）、任意の場所に配置します。例：~/bin/lucyd-mcp（Windows では lucyd-mcp.exe）。macOS と Linux では、chmod +x lucyd-mcp で実行可能にしてください。その後、以下の設定で npx の代わりにそのパスを使用します。

または、Rust を使ってソースからビルドします。

cargo install --git https://github.com/lucyd-trade/mcp-server

エージェントを接続する

キーを取引用ウォレットのキーに置き換えてください。その後、クライアントを再起動します。

Claude Code

claude mcp add lucyd -e LUCYD_PRIVATE_KEY=0xYOUR_KEY -- npx -y @lucyd/mcp

Claude Desktop：claude_desktop_config.json を編集します（macOS：~/Library/Application Support/Claude/、Windows：%APPDATA%\Claude\）。

Cursor：~/.cursor/mcp.json を編集します。

どちらも同じ形式を使用します。

{
  "mcpServers": {
    "lucyd": {
      "command": "npx",
      "args": ["-y", "@lucyd/mcp"],
      "env": {
        "LUCYD_PRIVATE_KEY": "0xYOUR_KEY"
      }
    }
  }
}

Windows のクライアントで npx を起動できない場合は、"command": "cmd" と "args": ["/c", "npx", "-y", "@lucyd/mcp"] を使用してください。

最初の取引の前に

ウォレットには、購入用の USDC と、初回の承認および償還時のガス代として少量の Sepolia ETH が必要です。その後、エージェントにウォレットを確認して取引を承認するよう依頼するか、approve_trading を直接呼び出してください。取引自体にガス代はかかりません。取引所が約定をオンチェーンで決済します。

設定

変数	デフォルト	意味
LUCYD_PRIVATE_KEY	なし	注文とトランザクションに署名するウォレットキーです。設定しない場合、取引ツールは無効になります
LUCYD_MAX_ORDER_USD	100	USDC での買い注文の上限額です
LUCYD_READ_ONLY	false	true にすると、取引またはトランザクション送信を行うすべてのツールが無効になります
LUCYD_RPC_URL	https://ethereum-sepolia-rpc.publicnode.com	Sepolia RPC ノードです
LUCYD_API_URL	https://api.testnet.lucyd.trade	マーケット API です
LUCYD_CLOB_URL	https://clob.testnet.lucyd.trade	オーダーブックです

安全性

• キーがマシンの外に出ることはありません。サーバーはローカルで署名し、署名済みの注文とトランザクションのみを送信します。
• エージェント用に別のウォレットを用意し、取引する準備ができている資金だけを入れてください。
• サーバーは取引前にユーザーへ確認するようエージェントに指示しますが、実際に確認するかどうかはエージェント次第です。LUCYD_MAX_ORDER_USD を低く設定するか、データの取得のみを行う場合は LUCYD_READ_ONLY=true に設定してください。

仕組み

サーバーはローカルで実行され、stdio を介してエージェントと通信します。マーケットデータは公開 API から取得します。注文は EIP-712 で署名され、WebSocket 経由でオーダーブックに送信されます（プロトコルについては API ドキュメント を参照してください）。承認と償還は Sepolia 上の通常のトランザクションです。

コントラクト	アドレス
Exchange	0x6588c789c6b6df8f8b6b92e6433f813cc2d1d4d0
ConditionalTokens（結果トークン）	0xB62eFc43C16b4E2Bf1aAAD33002368e55708538D
USDC（小数点以下6桁）	0x1c7D4B196Cb0C7B01d743Fbc6116a902379C7238
AutoRedeemer	0x42Bf669f0A3DCc95510001Ddbc43D56FdE67268F

ライセンス

MIT