SODAX Builders MCP

SODAX Builders MCP Server

お好みの MCP ディレクトリからインストール

   

AI コーディングアシスタント向けの SODAX MCP サーバーです。リアルタイムのクロスネットワーク（クロスチェーン）API データにアクセスできます。20 以上のネットワーク間でトークンをスワップしたり、マネーマーケットのレートを照会したり、ソルバーの取引量を確認したり、インテントの履歴を検索したりできます。SODAX 開発者ドキュメントと自動同期する、クロスチェーン SDK の包括的なドキュメントも含まれています。リアルタイムのプロトコルデータを開発ワークフローから直接利用して、クロスネットワーク DeFi 統合を構築できます。

一文で: SODAX MCP サーバー：20 以上のネットワークに対応する、リアルタイムのクロスネットワーク DeFi API データと自動更新される SDK ドキュメントです。AI コーディングアシスタントから、スワップ、レンディング、ソルバーの取引量、インテントの履歴を照会できます。

クイックスタート

AI コーディングアシスタントの設定に MCP サーバーの URL を追加します。

{
  "mcpServers": {
    "sodax-builders": {
      "url": "https://builders.sodax.com/mcp"
    }
  }
}

Claude、Cursor、VS Code、Windsurf、ChatGPT、その他の MCP 対応エージェントで利用できます。1 回接続するだけで、すべてのクロスネットワーク API ツールと SDK ドキュメントにアクセスできます。

SSE トランスポート（レガシー）

ストリーミング可能な HTTP に対応していないクライアント（例：Gemini CLI）では、代わりに SSE エンドポイントを使用します。

{
  "mcpServers": {
    "sodax-builders": {
      "url": "https://builders.sodax.com/sse"
    }
  }
}

ツール

ネットワーク設定（9 個のツール）

ツール	説明
sodax_get_supported_chains	クロスチェーンスワップで SODAX がサポートするすべてのブロックチェーンネットワークを一覧表示します
sodax_check_chain_support	名前、ティッカー、またはキー（例：「Hedera」、「HBAR」）で、SODAX がチェーンをサポートしているか確認します
sodax_get_swap_tokens	クロスネットワークスワップで利用できるトークンを取得します。チェーンで絞り込むこともできます
sodax_get_all_config	SODAX の全設定（チェーンとトークン）を 1 回の呼び出しで取得します
sodax_get_all_chains_configs	コントラクトアドレスと RPC を含む、スポークチェーンの詳細設定を取得します
sodax_get_relay_chain_id_map	チェーン ID とインテントリレーチェーン ID の対応表を取得します
sodax_get_hub_assets	スポークトークンに対応するハブ（Sonic）アセットを取得します
sodax_get_money_market_tokens	チェーンごとに、マネーマーケットがサポートするトークンを取得します
sodax_get_money_market_reserve_assets	マネーマーケットのリザーブアセットを取得します

インテントとソルバー（9 個のツール）

ツール	説明
sodax_get_transaction	ハッシュでインテントトランザクションを検索し、ステータス、金額、詳細を取得します
sodax_get_intent	インテントハッシュで特定のインテントを検索します
sodax_get_user_transactions	特定のウォレットアドレスのインテント／トランザクション履歴を取得します
sodax_get_volume	フィルタリングとページネーションに対応した、約定済みインテントのソルバー取引量データを取得します
sodax_get_volume_stats	集計済みのソルバー取引量統計を取得します
sodax_get_orderbook	ソルバーから現在のクロスチェーン注文板エントリを取得します
sodax_get_solver_intent	ソルバー側のインテント詳細と約定履歴を取得します
sodax_get_solver_oracle	サポート対象のすべての（チェーン、トークン）ペアについて、ソルバーのオラクル価格を取得します
sodax_get_solver_quote	ソルバーからスワップ見積もりを取得します（exact_input または exact_output）

インテントリレー（3 個のツール）

ツール	説明
sodax_relay_submit_tx	確認済みのスポークチェーントランザクションをインテントリレーに送信し、クロスチェーンで配信します
sodax_relay_get_transaction_packets	ソーストランザクションによって発行されたすべてのクロスチェーンパケットを一覧表示します
sodax_relay_get_packet	接続シリアル番号で単一のリレーパケットを取得します

AMM と流動性（2 個のツール）

ツール	説明
sodax_get_amm_positions	所有者ごとの AMM 流動性プロバイダー NFT ポジションを取得します
sodax_get_amm_pool_candles	AMM プールの OHLCV ローソク足チャートデータを取得します

マネーマーケット（6 個のツール）

ツール	説明
sodax_get_money_market_assets	すべての貸し出し／借り入れ可能な資産と金利を一覧表示します
sodax_get_money_market_asset	リザーブアドレスで指定した資産の詳細情報を取得します
sodax_get_user_position	ユーザーのマネーマーケットポジション（供給、借入、健全性）を取得します
sodax_get_asset_borrowers	指定したマネーマーケット資産の借り手を取得します
sodax_get_asset_suppliers	指定したマネーマーケット資産の供給者（貸し手）を取得します
sodax_get_all_borrowers	すべてのマネーマーケット資産にわたる借り手を取得します

パートナーとトークン（6 個のツール）

ツール	説明
sodax_get_partners	ネットワーク全体の SODAX 統合パートナーを一覧表示します
sodax_get_partner_summary	指定したパートナーの取引量とアクティビティの概要を取得します
sodax_get_token_supply	SODA トークンの供給量情報（総供給量、流通量、バーン量）を取得します
sodax_get_total_supply	SODA の総供給量を数値のみで取得します
sodax_get_circulating_supply	SODA の流通量を数値のみで取得します
sodax_refresh_cache	キャッシュデータを消去して最新の結果を取得します

クロスチェーン SDK ドキュメント（動的）

docs_ で始まるツールは、docs.sodax.com の SODAX ドキュメント MCP から自動的にプロキシされます。ドキュメントが変更されると自動で更新されるため、手動で同期する必要はありません。

ツール	説明
docs_search_sodax_docs	クロスチェーン SDK のドキュメント、統合ガイド、コード例を検索します
docs_query_docs_filesystem_sodax_docs	ドキュメントファイルシステムからドキュメントページ全体を読み込みます
docs_list_tools	利用可能なすべてのドキュメントツールを一覧表示します
docs_health	SDK ドキュメント MCP の接続状態を確認します
docs_refresh	ドキュメント MCP からツール一覧を更新します

プロンプトの例

接続したら、AI コーディングアシスタントに次のように質問してみてください。

ネットワーク間のスワップとトークン

• 「SODAX はクロスチェーンスワップでどのネットワークに対応していますか？」
• 「Base 上でチェーン間の利用可能なスワップトークンを取得して」
• 「SODAX SDK でクロスチェーンスワップを統合するにはどうすればよいですか？」

ソルバーの取引量とインテント履歴

• 「今日のネットワーク間のソルバー取引量を表示して」
• 「このインテントトランザクションを調べて：0x...」
• 「このウォレットアドレスのインテント履歴を取得して」
• 「Sonic 上で 100 USDC を SODA に交換する見積もりを出して」
• 「Avalanche 上の bnUSD について、ソルバーが参照している現在のオラクル価格はいくらですか？」

クロスチェーンリレー

• 「この送信元 tx のリレーパケットを追跡して：0x...」
• 「この tx の conn_sn=42 のパケットはもう実行されましたか？」

マネーマーケットと貸し出し

• 「SODAX マネーマーケットの貸出金利はいくらですか？」
• 「資産ごとの借入 APY 金利を表示して」
• 「自分のマネーマーケットポジションを取得して」

SDK ドキュメント

• 「SODAX クロスチェーン SDK と統合するにはどうすればよいですか？」
• 「ネットワーク間のトークンスワップのコード例を表示して」
• 「インテントベースの実行で利用できる SDK メソッドは何ですか？」

データソース

ソース	種類	キャッシュ
SODAX Backend API (api.sodax.com/v1/be)	ライブのネットワーク間データ	2 分
SODAX Solver API (api.sodax.com/v1/intent)	オラクル価格 + スワップ見積もり	2 分（オラクル）；なし（見積もり）
SODAX Intent Relay (xcall-relay.nw.iconblockchain.xyz)	クロスチェーンパケットの追跡	なし
Aggregator	クロスチェーンスワップのトークンデータ	2 分
SODAX Docs MCP (docs.sodax.com)	SDK ドキュメント	自動同期

ローカル開発

# Install dependencies
pnpm install

# Run in development mode
pnpm dev

# Build for production
pnpm build

# Start production server
pnpm start

# Run the test suite (unit tests for drift-check logic)
pnpm test

CI とローカルチェック

development／master へのすべての PR で .github/workflows/ci.yml が実行されます。このワークフローでは、ローカルで実行できる以下の 4 つのチェックと同じものを実行します。

コマンド	内容
pnpm checkTs	tsc --noEmit でプロジェクトの型チェックを行います（ビルド出力はありません）。
pnpm lint	リポジトリ全体に対して Biome（biome check .）を実行します。安全な修正を自動適用するには、:fix を追加します。
pnpm build	TypeScript をコンパイルし、src/public を dist/ にコピーします。
pnpm test	Vitest のテストスイートを実行します（現在は src/services/apiDriftCheck.ts のドリフトチェックロジックを対象としています）。

Git フック（husky + commitlint + lint-staged）

pnpm install を実行すると、prepare スクリプトを通じてフックが自動的にインストールされます。

• pre-commit — pnpm checkTs、pnpm test の順に実行した後、lint-staged を実行します（ステージされたファイルに対して biome check --write を実行し、フォーマットと安全なリント修正を適用します）。
• commit-msg — Conventional Commits の仕様に照らして commitlint を実行します。feat: add X のようなメッセージは受け入れられますが、bad message は拒否されます。

緊急時に一度だけフックをスキップするには、次のコマンドを実行します。

HUSKY=0 git commit -m "your message"

常用しないでください。CI では引き続き PR に対して同じチェックが実行されます。

環境変数

サーバーは起動時に .env ファイルを自動的に読み込みます（Node の --env-file-if-exists フラグを使用します。Node ≥ 22.9.0 が必要です）。ローカル開発では .env.example を .env にコピーしてください。.env がない場合、各変数には以下のデフォルト値が適用されます。本番環境では、Coolify がこれらの値をプロセス環境に直接設定します。

変数	デフォルト値	説明
PORT	3000	サーバーのポート
TRANSPORT	http	トランスポートモード（http または stdio）
NODE_ENV	-	デプロイ時は production に設定します
LOG_LEVEL	info	ログの詳細度。trace、debug、info、warn、error、fatal のいずれかです。
DISCORD_WEBHOOK_URL	-	実行時アラート用の Discord Webhook。サーバーの状態（起動／停止）、重大なエラー（捕捉されない例外／未処理の拒否）、API ドリフトの概要を通知します。空または未設定の場合は通知されません（ステージング／ローカル）。

デプロイ

環境

サーバーは Coolify を通じて、ブランチベースの昇格フローでデプロイされます。

• 本番環境 — master を追跡し、https://builders.sodax.com でサービスを提供します
• ステージング — development を追跡します（内部専用）

昇格フロー：

1. フィーチャーブランチ → development への PR → マージ時にステージングへ自動デプロイされます。
2. development → master への PR → マージ時に本番環境へ自動デプロイされます。

ホットフィックスは master からブランチを作成して master に直接 PR し、その後 development にマージして戻すことができます。

Docker

docker build -t builders-sodax-mcp-server .
docker run -p 3000:3000 builders-sodax-mcp-server

Docker Compose

docker-compose up -d

デプロイに関する注意

同梱の nixpacks.toml がデプロイを自動的に処理します。以下の環境変数を設定してください。

• PORT=3000
• NODE_ENV=production

API エンドポイント

エンドポイント	説明
GET /	ランディングページ
GET /api	サーバー情報とツール一覧
GET /health	ヘルスチェック
POST /mcp	MCP エンドポイント（ストリーミング可能な HTTP）
GET /sse	SSE エンドポイント（レガシートランスポート）
POST /messages	SSE メッセージエンドポイント

関連リンク

• SODAX — sodax.com
• SDK ドキュメント — docs.sodax.com（自動的にプロキシされます）

ライセンス

MIT