Ophis MCP

@ophis/mcp-server

Cloudflare Worker としてデプロイされ、Streamable-HTTP トランスポートを使用する、Ophis DEX 向けのエージェント用 MCP サーバーです。接続先は https://mcp.ophis.fi/mcp です。

現在のサーバーリリースは v0.2.0 で、設定済みの15の EVM チェーン（14のメインネットと Sepolia）にわたって13個のツールを提供します。

自律型エージェントと MCP クライアントに Ophis の取引機能を公開します。フォーク固有の、見落としやすく間違えやすい詳細（Ophis 運営チェーン上の非標準の決済コントラクト、セルフホストされた Optimism、Unichain、Robinhood Chain、Arc のオーダーブックホスト、CIP-75 パートナーフィーの appData 形式、レシーバーの固定）をエージェント側で再導出する必要はありません。

Arc（5042）では、基本手数料 1 bp が課され、ルーティングされた取引量のインデックス作成と紹介の帰属に対応しています。サーバーの紹介デフォルトが適用されます。呼び出しごとのコードを指定するとデフォルトが上書きされ、空文字列を指定すると無効になります。注文が受理されると、submit_order は所有者をインデックス作成と進行中のトレード報酬キャンペーンに登録します。

ツールは、設定済みの EVM オーダーブックで動作します。list_chains は設定内容を返すものであり、稼働状況をリアルタイムで確認するものではありません。スタンドアロンアプリの、外部資金を使う NEAR のソースフローは別の機能です。これらのツールでは、その入金の作成や資金供給は行いません。ネットワークと資金供給の対象範囲を参照してください。

セキュリティモデル

サーバーは秘密鍵を保持せず、署名も行いません。build_order は、注文のレシーバーを所有者に固定した、制約付きの署名可能な EIP-712 ペイロードを返します（自律型エージェントの資金を流出させる最大の原因です）。エージェントは自身の鍵で署名して送信します。これは V1 の「制約付きケイパビリティ」パターンであり、オンチェーンの認可境界ではなく、オフチェーンでの不正使用を防ぐものです。すべての基盤エンドポイントはすでに公開されており、ツールは読み取りと構築のみを行うため、認証は不要で、誰でも利用できます。

ツール

ツール	目的
parse_intent	平易な英語でのスワップ要求 → 構造化されたインテント（swap.ophis.fi/api/intent 経由の LibertAI Qwen）。
resolve_token	信頼できる Ophis リストからトークンシンボルを正規アドレスに解決します。なりすまし対策として、安全側に失敗します。
list_chains	対応チェーン、オーダーブックホスト、決済コントラクト、パートナーフィーの設定。
get_quote	チェーンの Ophis オーダーブックから最良執行の見積もりを取得します（/api/v1/quote）。
expected_surplus	公開アグリゲーター（KyberSwap）と比較した価格改善をベーシスポイント単位で推定します。
build_order	制約付きで署名可能な CoW 注文を構築します。チェーンごとの正しい決済先とオーダーブック、appData 内の CIP-75 パートナーフィー、所有者に固定されたレシーバーを使用します。
submit_order	署名済みの注文をオーダーブックにリレーします（/api/v1/orders）。ここでは鍵を保持しません。
get_integrator_earnings	appCode ごとに、CoW がホストするチェーン上のルーティング取引量、Ophis の基本手数料、インテグレーター独自の手数料を取得します（rebates.ophis.fi/earnings/:appCode）。
get_balances	1つのチェーン上にあるアドレスのネイティブトークンと ERC-20 の残高。
get_portfolio	複数のチェーンにまたがるネイティブトークンと ERC-20 の残高。
get_gas	チェーンの現在のガス価格を取得します（参考情報です。オフチェーン注文の署名はガス不要ですが、承認やその他のウォレット取引にはガスが必要です）。
get_token_chart	トークンの OHLCV 価格履歴。
validate_order	外部で構築された注文のオフライン事前チェック（ネットワーク接続も鍵も不要）。誤った appCode、オーダーブックホスト、EIP-712 ドメイン、appData ハッシュの不一致、レシーバーの固定漏れ、期限切れ、またはゼロ以外の手数料を検出します。

エージェントの一般的なフロー

parse_intent("swap 100 USDC for WETH on Optimism")
  → resolve_token({ chainId, symbol }) for BOTH the sell and buy symbols   // canonical addresses, fails closed (anti-spoof); for a native-coin request like ETH, resolve the wrapped symbol (WETH)
  → get_quote({ chainId, sellToken, buyToken, kind:'sell', amount, from })
  → build_order({ chainId, owner, sellToken, buyToken, sellAmount, buyAmount /* slippage-adjusted */, kind })
  → (agent confirms with the user, then signs `order` as EIP-712 using `signing`)
  → submit_order({ chainId, order, signature, from, fullAppData })

開発

pnpm --filter @ophis/mcp-server test         # unit tests (pure logic)
pnpm --filter @ophis/mcp-server typecheck
pnpm --filter @ophis/mcp-server dev          # wrangler dev (local Streamable HTTP)
npx @modelcontextprotocol/inspector@latest   # point at http://localhost:8787/mcp

dev／deploy／dry-run は最初にワークスペース SDK を自動ビルドするため（pre* スクリプト）、クリーンなチェックアウトでも手動で @ophis/sdk をビルドせずに動作します。

デプロイ

.github/workflows/mcp-deploy.yml を介して、main へのプッシュ時に自動デプロイされます。最小限の権限を持つ CLOUDFLARE_WORKERS_TOKEN シークレット（Workers Scripts と Routes のみ）を使用します。手動の場合：

pnpm --filter @ophis/mcp-server deploy        # builds the SDK, then wrangler deploy → mcp.ophis.fi

カスタムドメイン mcp.ophis.fi は、wrangler.jsonc（routes）からプロビジョニングされます。

main へのデプロイが成功した後、組織の管理者が対応する mcp-v<x.y.z> タグを作成します。.github/workflows/mcp-registry-release.yml が稼働中の /health のバージョンと一致することを確認してから、server.json を公式の MCP Registry に公開します。リリース手順書を参照してください。