DeXe DAO governance

dexe-mcp

DeXe ProtocolのBNB Chain上でのガバナンスに対応するMCP（Model Context Protocol）サーバーです。OpenZeppelinおよびCompound-Bravo GovernorのDAO（Uniswap、Compound、Optimism）向けの汎用インターフェースも備えています。

19グループに分類された、型定義済みの170個のツールを提供します。DAOのデプロイ、DeXeの全33種類の提案、投票、委任、実行、OTCトークン販売、トレジャリーとサブグラフの読み取り、1回の呼び出しによるDAOレポート、IPFSメタデータ、トランザクションのシミュレーション、マルチエージェントのオーケストレーション、診断に対応しています。ローカルコマンドを起動できるMCPクライアントであれば、Claude Code、Claude Desktop、Cursor、Codex CLI、カスタムエージェントなどから利用できます。また、パッケージには読み取り専用版のdexe-mcp-readも含まれています。これは読み取り専用の54個のツールを備え、stdioまたはHTTP経由でリモートクライアントから利用できます。詳しくは読み取り専用版をご覧ください。

書き込み操作は、calldataを優先する方式です。ツールは、ユーザー自身のウォレットで署名するための{ to, data, value, chainId }ペイロードを返します。サーバーからのブロードキャストはオプトイン方式で、人間がすべてのトランザクションを確認します。確認方法は、WalletConnect（スマートフォンで承認し、キーはディスクに保存しません。デフォルト）または暗号化されたローカルキーストア（ローカルページで各バッチをパスワードを使って承認）です。署名を伴う操作を人の監視なしに行うプレーンテキストのホットキーは、ボットとCI専用で、デフォルトではテストネットに設定されています。docs/SIGNING.mdで各モードと、それぞれが防ぐリスクについて説明しています。

インストール · クイックスタート · ツール一覧 · 環境変数 · ドキュメント

---

Claude Codeへのインストール

Claude Code内で次の2つのコマンドを入力します。

/plugin marketplace add edward-arinin-web-dev/dexe-mcp
/plugin install dexe@dexe-mcp

続いて、次のように尋ねてください。

「BSC上の0x…のトレジャリーを表示してください。」

設定しなくても、オンチェーンデータ、サブグラフ、DeXeバックエンド、IPFSの読み取りを利用できます。これらにはすべてパブリックなデフォルト設定があり、WalletConnectによる署名もすぐに利用できます（dexe_wc_connect）。プラグインとともに8つのスキルがインストールされます。dexe-setup、dexe-create-dao、dexe-create-proposal、dexe-vote-execute、dexe-otc、dexe-staking、dexe-report（設定不要）、dexe-agent-team（DEXE_TOOLSETS=core,agentsと、DEXE_SIGNER_MODE=unattendedに設定したホットキーが必要）です。

DAOや提案の作成、またはトランザクションのブロードキャストを行うには、/dexe-setupを実行してください。これらの操作を可能にする2つのキー（IPFSアップロード用のPinataトークンと署名者）の設定方法を案内し、サーバーが実際に読み込む.envに書き込みます（プラグインをインストールした場合は~/.dexe-mcp/.env）。

Cursor、Claude Desktop、Codex CLI、その他のローカルMCPクライアント、またはターミナルから利用する場合は、docs/INSTALL.mdをご覧ください。

読み取り専用エディション（dexe-mcp-read）

同じパッケージに含まれる2つ目のバイナリは、読み取り専用の54個のツールを提供します。対象は、DAO、提案、投票と投票者、トレジャリー、メンバー、委任、バリデーターと専門家、トークン販売、ステーキング、プロトコル統計、外部のGovernorです。署名、送信、アップロード、トランザクションの構築はできません。そのためのコードはプロセスに読み込まれることすらなく、呼び出し間で状態も保持しません。設定不要で読み取りを行い、共有の.envに署名キーやアップロードキーがあっても無視して破棄します。

claude mcp add dexe-read -- npx -y -p dexe-mcp dexe-mcp-read      # Claude Code

{ "mcpServers": { "dexe-read": { "command": "npx", "args": ["-y", "-p", "dexe-mcp", "dexe-mcp-read"] } } }

dexe-mcp-read serve-httpは同じツールをMCP Streamable HTTP経由でリモートクライアント（Claude.aiのカスタムコネクタ、ChatGPTの開発者モード）に提供します。Dockerイメージのレシピが同梱されており、プレリリース版です。運用担当者向け：docs/REMOTE.md。

クイックスタート（その他のMCPクライアント）

読み取りには環境設定は必要ありません。以下の手順では、アップロードと署名を設定します。

ウィザードを使う場合：

npx -y dexe-mcp@latest --version   # what you are about to run
npx -y dexe-mcp@latest init        # interactive setup: network, Pinata, signer mode
npx -y dexe-mcp@latest doctor      # verifies RPC, Pinata, IPFS gateway, subgraph

--helpと--versionは、環境を読み込まずに表示して終了します。initは~/.dexe-mcp/.env（ソースをチェックアウトした場合はリポジトリのルートにある.env）を書き込み、クライアント設定用のスニペットを表示します。doctorは認識されているすべてのDEXE_*変数を確認し、対処方法のヒントとともに合格／警告／失敗を報告します。設定なしでインストールした場合、警告は通常どおりです。終了コードは0です。CIで警告時の終了コードを1にするには、--strictを渡すか、DEXE_DOCTOR_STRICT=1を設定してください。実際に失敗した場合は2になります。手順の全容：docs/SETUP.md、チェック項目のリファレンス：docs/DOCTOR.md、アップグレードに関する注意事項：docs/MIGRATION.md。

すでにグローバルインストール済みですか？その場合はdexe-mcp initを使ってください。**2つの方法を混在させないでください。**グローバルインストールがnpx dexe-mcp@<version>より優先されるため、古いコードが気づかないまま実行されます（docs/INSTALL.md）。

手動で設定する場合 — MCPクライアント（.mcp.json、claude_desktop_config.json、Cursorの設定）に登録します。

{
  "mcpServers": {
    "dexe": {
      "command": "npx",
      "args": ["-y", "dexe-mcp@latest"]
    }
  }
}

グローバルインストールの場合も、同じ設定ブロックを{ "command": "dexe-mcp" }にします。既定値を上書きする場合にのみ、envブロックを追加してください。

{
  "mcpServers": {
    "dexe": {
      "command": "dexe-mcp",
      "env": {
        "DEXE_RPC_URL_MAINNET": "https://bsc-dataseed.bnbchain.org"
      }
    }
  }
}

envブロックは省略可能です。指定しない場合、サーバーはレート制限があり評価用途に適した公開BSC RPCにフォールバックします。本番環境では独自のエンドポイントを設定してください。

Windows： MCPクライアントがPATH上のdexe-mcpシムを解決できない場合は、スクリプトを直接指定してください。 { "command": "node", "args": ["<npm root -g>/dexe-mcp/dist/index.js"] }

呼び出し例（4つとも既定のプロファイルに含まれています。DEXE_TOOLSETSも環境変数も不要です）。

// The whole DAO in one call: identity, treasury, members, delegation,
// turnout, and everything with a deadline
dexe_dao_report({ govPool: "0x...", chainId: 56 })

// ...and on the next run, only what moved since the previous one
dexe_dao_report({ govPool: "0x...", chainId: 56, since: "last" })

// Enumerate every proposal type the server can build
dexe_proposal_catalog({ category: "all", implementedOnly: true })

// Create a proposal of ANY catalog type — proposalType + params
dexe_proposal_create({
  govPool:      "0x...",
  title:        "Pay the audit invoice",
  proposalType: "token_transfer",
  params:       { token: "0x...", recipient: "0x...", amount: "1000.0" }
})

dexe_proposal_createは、オンチェーンのすべてのカタログタイプに対応します。単機能のdexe_proposal_build_*ビルダー（生のcalldataを生成し、タイプごとに1つのツールが用意されています）を使うには、DEXE_TOOLSETS=core,proposalsが必要です。

各書き込みツールは、ウォレットに渡すTxPayloadを返します。サーバーにブロードキャストさせるには、WalletConnect経由でウォレットを接続する（dexe_wc_connect）か、npx dexe-mcp key createで暗号化キーを作成してDEXE_SIGNER_MODE=keystoreを設定してください。すると各バッチ（およびオフチェーンログインやSafeの署名のたび）にローカルの承認ページが開き、パスワードを求められます。または、npx dexe-mcp approveを使ってターミナルで承認できます。これにより、複合フローのdexe_proposal_create、dexe_proposal_vote_and_execute、dexe_tx_sendが利用可能になります。ホットキーのDEXE_PRIVATE_KEYで署名できるのはDEXE_SIGNER_MODE=unattendedの場合のみです（ボット、CI）。詳しくはdocs/SIGNING.mdを参照してください。

必要条件

• Node.js ≥ 20.12と、正常に動作するnpm（.envの読み取りに使われるprocess.loadEnvFileには20.12以降が必要です）。node -vで確認してください。
• Git — オプションの開発用ツールセット（dexe_compile／dexe_test／dexe_lint）でのみ必要です。初回使用時にDeXe-Protocolを浅くクローンします。既存のチェックアウトを使うには、DEXE_PROTOCOL_PATHを設定してください。読み取り、ビルダー、デプロイではGitを使用しません。

機能

• DeXe ガバナンスを網羅：33 種類の提案タイプ（外部 24 種、内部バリデーター 4 種、オフチェーン 5 種）、バリデーターチャンバー、エキスパートへの委任、Merkle ホワイトリストを使った複数段階の OTC 販売に対応します。
• Calldata ファーストのキー設計：ビルドツールでは秘密鍵は不要です。ブロードキャストは別途、明示的にオプトインする必要があります。
• 設定不要の読み取り：パブリック RPC、サブグラフ、バックエンド、IPFS ゲートウェイのデフォルト設定により、読み取りツールはすぐに使えます。これには、DAO 全体（アイデンティティ、トレジャリー、メンバーシップ、委任、投票率、期限）を 1 回の呼び出しで返し、前回の実行結果との差分も取得できる dexe_dao_report が含まれます。docs/REPORTING.md
• 外部 Governor に対応：18 種類の dexe_gov_* ツールで、OpenZeppelin および Bravo Governors の読み取り、ビルド、シミュレーション、デコードができます。新しい DAO は設定項目を追加するだけで対応できます。
• マルチエージェント・オーケストレーション：1 つの DAO に対して、複数のウォレットをペルソナとして実行できます。書き込み用コンポジット（dexe_dao_create、dexe_proposal_create、dexe_proposal_vote_and_execute、dexe_tx_send、OTC 購入用コンポジット）の signerKey で、キーリング内のどのウォレットで署名するかを選択できます。dexe_agents_fund は資金調達計画をプレビューし、confirm: true の場合に限り、エージェントごとの上限と直近 24 時間の支出予算を適用したうえで資金を移動します。dexe_agents_ledger では、各ペルソナが何を行い、いくらかかったかを確認できます。.env にホットキーを複数保管するのは、装填済みの銃を置いておくようなものです。実際の資金を保有する DAO でペルソナを実行する前に、安全性の仕組み、強制される制限と助言にとどまる事項、テストネットを優先するワークフローについて、docs/AGENTS.md をお読みください。
• オンチェーンでテスト済み：69 シナリオのマルチエージェント・ハーネスで、BSC-testnet のフィクスチャ DAO を対象にビルダーをテストします。すべての提案タイプをビルドのみで検証し、ブロードキャスト経路では提案から投票、実行までのライフサイクル全体をテストします。
• MIT ライセンス、テレメトリーなし、ホスト型サービスへの依存なし。リクエストは設定したエンドポイントにのみ送信されます。

アプリケーション例

検証済みのプロンプトレベルのシナリオは docs/USE_CASES.md にあります。それぞれ、使用する正確なツールとオンチェーンの証拠を記載しています。主な例：

• 基本操作 — DAO 独自のトークンを含む DAO を 1 回の呼び出しで作成する、提案 → 投票 → 実行、既存の DAO に参加する。
• ライブデータに関する Q&A — 「DAO X にはバリデーターがいますか？」、大口保有者マップ、TVL チャート、委任グラフ、提案ごとの投票者リスト。（v0.31.0 以降、レポート用の読み取り機能はデフォルトプロファイルに含まれ、キーは不要です：dexe_dao_report、dexe_graph_query、dexe_graph_schema、DAO の一覧／メンバー／統計、トークン保有者、委任マップ。dexe_dao_report の turnout セクションには、提案ごとの投票者数がすでに含まれています。利用頻度の低い読み取り機能（名前付き投票者リスト（dexe_proposal_voters）、バリデーター名簿、ユーザーごとのアクティビティ、ローカルエキスパート、プロトコル統計、NFT、受信箱／予測／リスク）は引き続き read プロファイルにあります。DEXE_TOOLSETS=core,read（または full）を設定するか、dexe_context に無効なセットと有効化方法を確認してください。）_
• 自動化 — 読み取り機能をエージェントのスケジューラー（/loop、/schedule）と組み合わせます。スケジュールされた dexe_dao_report に since: "last" を指定すると、前回の実行以降に変化した内容だけを報告できます。さらに、提案の監視、毎日のガバナンスダイジェスト（dexe_user_inbox）、定足数トラッカー、トレジャリーモニター、ポリシーベースの委任エージェントも利用できます。
• 分析 — 任意の提案をデコードしてリスク評価する（定足数の安全性、リスクにさらされるトレジャリー、利益を得るのは誰か）、購入前に DAO をデューデリジェンスする、ブロードキャスト前にシミュレーションする。
• 高度な運用 — DAO から任意の外部コントラクトを呼び出す（custom_abi）、OTC 販売、DAO 間の委任（ある DAO が別の DAO 内で投票する。メインネットで稼働中）、外部 Governor DAO、Safe マルチシグ。

ツールカタログ

19 グループに 170 種類のツールを収録しています。必須の環境変数を含む、ツールごとの完全なリファレンス：docs/TOOLS.md。 デフォルトのセッションでは core プロファイルが読み込まれます — 46 個のツール、tools/list は約 94 KB です。 これには、利用案内（dexe_context、dexe_write_context、dexe_guide、dexe_doctor）、1 回の呼び出しで完了する複合ツール（dexe_dao_create、dexe_proposal_create、dexe_proposal_vote_and_execute、4 つの dexe_otc_* 複合ツールと、トークンセールの読み取りツール dexe_read_token_sale_position／dexe_read_token_sales）、署名（dexe_tx_send、dexe_tx_approval_status、WalletConnect、主要な投票ビルダー）、IPFS アップロード用の 3 つのツールと dexe_ipfs_fetch、dexe_dao_info／dexe_dao_registry_lookup／dexe_dao_predict_addresses、dexe_proposal_state／_list／_catalog、dexe_read_treasury／_settings、そして設定不要のレポート用読み取りツール（dexe_dao_report、dexe_graph_query、dexe_graph_schema、DAO の一覧／メンバー／統計、トークン保有者、委任マップ）が含まれます。実行するプロファイルと、それぞれのコストについては、docs/PROFILES.md をご覧ください。

v0.31.0 での変更点：用途が限定された約 30 個の dexe_proposal_build_* ビルダーは、デフォルトでは読み込まれなくなりました。dexe_proposal_create は proposalType と params を使って、オンチェーンカタログのすべてのタイプに対応します。また、dexe_proposal_catalog から引き続き一覧を取得できます。以前の v0.31 のデフォルト設定をそのまま復元するには、DEXE_TOOLSETS=core,proposals を設定してください。プロファイル（proposals、read、vote、agents、governor、dev）を追加するか、すべてを有効にするには DEXE_TOOLSETS=full を設定してください。詳しくは docs/PROFILES.md をご覧ください。full を選ぶ前にご注意ください。これは 170 個すべてを登録しますが、一部のホスト（VS Code／GitHub Copilot）では、1 回のチャットリクエストで有効にできるツールが 128 個までに制限されており、それを超えるとセッションが拒否されます。この上限を超えると、サーバーは起動時に通知を表示します。セッションではまず dexe_context を呼び出してください。アクティブなチェーン、環境の準備状況、無効になっているプロファイルと各プロファイルで利用可能になる機能、以前のセッションで記録された DAO／提案が返されます。v0.36.0 以降、署名者、エージェントのキーリング、Pinata／WalletConnect／Safe の設定状況は dexe_write_context から確認できます。

v0.32.0 で追加：マルチペルソナのエージェント群を実行するための第 7 のプロファイル、agents。dexe_agents_list（キーリング内のエージェントとその残高を確認）、dexe_agents_fund（上限が適用される範囲内で、残高を追加。プレビュー後に確定）、dexe_agents_ledger（誰が何を行い、どれだけのコストがかかったかを確認）が含まれます。DEXE_TOOLSETS=core,agents を設定して再起動してください。シナリオで委任やバリデーターの生のビルダーが必要な場合は、vote（core,agents,vote）を追加します。dexe_agents_list／dexe_agents_fund は vote にも含まれるため、既存の core,vote セッションで利用できるツール群はそのまま維持されます。詳細と安全モデルについては、docs/AGENTS.md をご覧ください。

Tools 列の数はグループ全体のツール数であり、デフォルトのセッションで読み込まれる数ではありません。ほとんどのグループはプロファイルを有効にすると利用できます。docs/TOOLS.md では、各セクションの冒頭にプロファイル名が記載されています。

グループ	ツール	概要
開発ツール	4	DeXe-Protocol ワークスペースの Hardhat ライフサイクル：dexe_compile、_test、_coverage、_lint。
コントラクトの調査	10	コントラクトの一覧表示、ABI の取得、セレクターの検索、NatSpec とソースの読み取り、calldata と提案ペイロードのデコード。
DAO の読み取り	34	dexe_dao_report — DAO 全体（識別情報、設定、トレジャリー、メンバーシップ、委任、エキスパート、バリデーター、提案、投票率、アクティビティ、期限）を 1 回の呼び出しで取得し、任意の since 差分にも対応 — さらに DAO 情報、提案の状態／一覧／投票者、投票権、トレジャリー、設定、バリデーター、ステーキング、分配、リスク評価、プロトコル全体の統計、サブグラフクエリ（DAO 一覧、メンバー、エキスパート、委任マップ、ユーザーアクティビティ、自由形式の dexe_graph_query、dexe_graph_schema によるライブスキーマのイントロスペクション）。
IPFS	9	ファイル、アバター、DAO／提案メタデータの Pinata アップロード、メタデータ更新、JPEG アバター生成、ゲートウェイフォールバックによる取得、ローカル CID の計算。
DAO のデプロイ	2	dexe_dao_create（プリフライトのリバートガードを備えた 1 回呼び出しの複合ツール）と dexe_dao_build_deploy（完全な deployGovPool 構造体エンコーダー）。
提案カタログとプリミティブ	5	dexe_proposal_catalog と汎用の _build_external、_build_internal、_build_custom_abi、_build_offchain。
外部提案ラッパー	20	名前付きビルダー：トークンの送金／分配／販売、トレジャリーの引き出し、バリデーター、エキスパート、ステーキングティア、ブラックリスト、プロフィール変更、投票設定など。
内部バリデーターラッパー	4	バリデーターチェンバーの提案：残高、設定、月次引き出し、オフチェーンの内部処理。
オフチェーンラッパーと認証	9	DeXe バックエンドとの連携：SIWE ログイン、オフチェーンの提案作成と投票。
投票、ステーク、委任、実行、請求のビルダー	26	GovPool と Validators への直接的な EOA 書き込み：デポジット、投票、委任、実行、請求、ステーキング、トークン販売の購入／請求、マルチコール。
複合署名フロー	12	dexe_guide（複数ステップのリクエストでは最初に呼び出してください）、dexe_proposal_create、dexe_proposal_vote_and_execute、dexe_tx_send、dexe_tx_status、dexe_tx_approval_status（キーストアの承認、読み取り専用）、dexe_get_config、dexe_context、dexe_write_context（署名者、キーリング、アップロード／WalletConnect／Safe の状態）、さらにエージェントのキーリング — dexe_agents_list、dexe_agents_fund、dexe_agents_ledger（v0.32）。これらは agents プロファイルが有効な場合にのみ使用できます。
Merkle ユーティリティ	2	OZ StandardMerkleTree と互換性のある dexe_merkle_build と dexe_merkle_proof。
OTC 複合ツール	4	複数ティアの販売を開始、購入者のポジションを読み取り（dexe_read_token_sale_position）、購入（ネイティブまたは merkle proof を使用）、権利確定済みの支払いを請求。docs/OTC.md
Safe マルチシグ	2	ブロードキャストの代わりに Safe Transaction Service でトランザクションをキューに登録。docs/SAFE.md
シミュレーター	3	デコード済みのリバート理由を含む eth_call プリフライト：_sim_calldata、_sim_proposal、_sim_buy。docs/SIMULATOR.md
複数 DAO の受信トレイ＋予測	2	N 個の DAO にまたがる保留中項目（dexe_user_inbox）と、定足数に基づく可決率予測。docs/INBOX.md
外部 Governor DAO	18	dexe_gov_*：ファミリーに応じた提案／投票／キュー登録／実行／委任、ドライラン、投票レシート、OZ および Bravo Governor 向けのデコード。docs/GOVERNOR.md
WalletConnect	3	dexe_wc_connect（ペアリング QR）、dexe_wc_status、dexe_wc_disconnect。トランザクションはスマートフォンで署名します。docs/WALLETCONNECT.md
診断	1	dexe_doctor：設定済み環境全体の到達可能性チェックを実行し、修正のヒントを表示します。

環境変数

サーバーの起動に必要な変数はありません。不足している変数を必要とするツールは、設定すべき変数名を示すメッセージとともに失敗します。全項目については、docs/ENVIRONMENT.mdをご覧ください。

変数	用途	備考
DEXE_RPC_URL_MAINNET / DEXE_RPC_URL_TESTNET / DEXE_RPC_URL_<chainId>	すべてのオンチェーンツール	チェーンごとのJSON-RPCエンドポイントです。何も設定されていない場合は、パブリックBSC RPCが使用されます（レート制限あり）。従来の単一チェーン用エイリアスDEXE_RPC_URLも引き続き使用できます。
DEXE_DEFAULT_CHAIN_ID	チェーンの選択	デフォルトは56（BSCメインネット）です。テストネットの場合は97です。
DEXE_DISABLE_PUBLIC_RPC	セキュリティ強化	1を設定すると、パブリックRPCへのフォールバック（BSC、およびdexe_gov_*ツールが使用するアーカイブ対応のEthereum／Optimismへのフォールバック）を無効にします。
DEXE_PINATA_JWT	IPFSへのアップロード	DAO／提案の作成をブロードキャストする場合（メタデータのピン留め）に必要です。プレビューとdryRunにはキーは不要です。同じCIDをオフラインで計算します。
DEXE_IPFS_GATEWAY	IPFSの読み取り	専用ゲートウェイ（Pinata、Filebase、セルフホスト）を指定します。設定されていない場合は、パブリックゲートウェイ（ipfs.io、dweb.link）が使用されます。
DEXE_PINATA_GATEWAY_TOKEN	IPFSの読み取り	アクセス制限のあるPinata専用ゲートウェイ用のキーです。
DEXE_IPFS_DISABLE_PUBLIC_FALLBACK	セキュリティ強化	1を設定すると、パブリックゲートウェイへのフォールバックを無効にします。
DEXE_WALLETCONNECT_PROJECT_ID	WalletConnectによる署名	共通のデフォルト値が設定されています。本番環境で使用する場合は、独自のプロジェクトIDを設定してください。
DEXE_SIGNER_MODE	署名	walletconnect（デフォルト） · keystore（暗号化されたキー。ローカルページでバッチごとにパスワードを入力 — npx dexe-mcp key create） · readonly · unattended（ホットキーを使い、確認なしで署名。DEXE_UNATTENDED_CHAINSのみ対象。デフォルトは97）。docs/SIGNING.mdをご覧ください。
DEXE_PRIVATE_KEY	unattendedモード	ホットキーによる署名に使用します。読み取られるのはDEXE_SIGNER_MODE=unattendedの場合のみです。モードが未設定の場合、ホットキーは無視されます（1.0.0以降）。npx dexe-mcp key import --from-envでキーストアに移してください。
DEXE_TOOLSETS	ツールの制御	プロファイルをカンマ区切りで指定します。デフォルトはcore（v0.31.0。以前はcore,proposals）です。有効な値はcore、proposals、read、vote、agents、governor、dev、fullです。agents（v0.32.0）を指定するとキーレスリングのフリートツールが追加されます — DEXE_TOOLSETS=core,agents。
DEXE_SUBGRAPH_POOLS_URL / _VALIDATORS_URL / _INTERACTIONS_URL	サブグラフの読み取り	The Graphのエンドポイントです。デフォルトでは分散型ネットワークを参照します。
DEXE_GRAPH_API_KEY	サブグラフの読み取り	URLにキーが含まれていない場合にのみ必要です。
DEXE_BACKEND_API_URL	オフチェーン提案	DeXeバックエンドのURLです。例：https://api.dexe.io。
DEXE_STATE_PATH	永続化	セッション状態ファイル（~/.dexe-mcp/state.json）を上書きします。
DEXE_PROTOCOL_PATH	devツールセット	既存のDeXe-Protocolチェックアウトを指定します。自動クローンは無効になります。
DEXE_SAFE_DELEGATECALL	セキュリティ強化	blockを設定すると、Safeのoperation: 1を無条件に拒否します。デフォルトでは、DELEGATECALLには呼び出し時にallowDelegateCall: trueを明示する必要があります。
DEXE_DOCTOR_STRICT	CI	1を設定すると、警告がある場合にdexe-mcp doctorが1で終了します（--strictと同じ動作）。

ドキュメント

• docs/USE_CASES.md — 検証済みのユースケース一覧：エージェントへの指示内容、実行される処理、オンチェーンの証拠。
• docs/PLAYBOOK.md — AI 向けプレイブック：意図 → 正確な呼び出し、タイプごとのパラメーター、エラー → 対処方法。MCP リソース dexe://playbook としても提供されます。
• docs/TOOLS.md — 全 170 ツールをグループ別に掲載。各ツールの説明、セクションごとに必要なツールセットのプロファイル、必須の環境変数も記載しています。MCP リソース dexe://tools としても提供されます。
• docs/REPORTING.md — dexe_dao_report：1 回の呼び出しで作成する DAO レポート、その各セクション、since による差分、定期実行の方法。
• docs/USAGE.md — コピーして貼り付けられる JSON を使った実例。
• docs/ENVIRONMENT.md — 環境変数の完全なリファレンスとよくある注意点。
• docs/INSTALL.md — MCP クライアントごとのインストール手順。
• docs/PROFILES.md — 実行する DEXE_TOOLSETS プロファイル、各プロファイルが tools/list で消費する数、ホストのツール数上限。
• docs/SETUP.md / docs/DOCTOR.md — セットアップウィザードと診断リファレンス。
• docs/AGENTS.md — マルチペルソナのエージェントチーム：ホットキーのフリート向け安全性モデル、agents ツールセット、資金調達ガード、オンチェーンで機能する実行手順、アトリビューション台帳。
• docs/SKILLS.md — パッケージに同梱される Claude Code スキル。
• docs/GRAPH.md — dexe_graph_query のサブグラフエンティティリファレンス（プール／インタラクション／バリデーター）。MCP リソース dexe://graph-schema としても提供されます。
• docs/GOVERNOR.md — 外部の OZ/Bravo Governor の機能。
• docs/SIGNING.md — 署名モード（WalletConnect、暗号化キーストア、読み取り専用、無人実行）、承認ページ、脅威モデル。
• docs/WALLETCONNECT.md — ホットキーを使わず、スマートフォンで承認して署名する方法。
• docs/OTC.md — 所有者と購入者向けの複数段階 OTC 売却フロー。
• docs/PROFILE.md — DAO プロファイルとアバターのパイプライン。
• docs/SIMULATOR.md — リバートのデコード機能を備えた事前シミュレーション。
• docs/INBOX.md — DAO 横断の受信トレイと提案の予測。
• docs/MIGRATION.md — バージョンごとのアップグレードに関する注意事項。
• docs/REMOTE.md — 読み取り専用版 dexe-mcp-read：stdio のセットアップと、HTTP（serve-http、Docker）経由でリモートクライアント向けにホストする方法。

Swarm テストハーネス

tests/swarm/ は、実際の BSC-testnet DAO に対してツールの機能をテストするマルチエージェントハーネスです。委任チェーン、バリデーターチャンバー、あらゆる提案タイプのビルドのみのチェック、OTC フロー、ブロードキャストの全ライフサイクルを網羅する 69 の JSON シナリオが含まれています。オーケストレーターはエージェントのウォレットを解決し、インラインの ethers ディスパッチャーまたは dexe-mcp stdio ブリッジを通じて各ステップを実行します。

npm run swarm:preflight                # per-wallet readiness table
npm run swarm:fund -- --confirm        # top up agent wallets from the funder
npm run swarm:run                      # full sweep
npm run swarm:run -- --scenarios=S00-reset --dry-run

セットアップ手順書：tests/swarm/README.md · シナリオのスキーマ：tests/swarm/scenarios/_schema.md · エージェントのプロンプト：tests/swarm/prompts/。

コントリビューション

git clone https://github.com/edward-arinin-web-dev/dexe-mcp.git
cd dexe-mcp
npm install
npm run build
npm test
npm run dev          # watch mode

問題の報告、PR、提案タイプのリクエスト：GitHub issues。

セキュリティ

脅威モデル、ポリシー、脆弱性の報告方法については、SECURITY.md を参照してください。要点は次のとおりです。

• リリースタグには GPG 署名が付いており、公開前に release.yml が git verify-tag を実行します。メンテナーの鍵をインポートした後、git verify-tag <tag>（例：v0.19.0）でローカル環境から検証できます。
• npm リリースは --provenance を指定して公開されます。npm audit signatures で検証できます。
• CI はコミット済みのロックファイルのみから厳密にインストールし、差分がある場合は失敗します。
• PR および定期実行で、CodeQL、OSSF Scorecard、Dependency Review が実行されます。

ライセンス

MIT。詳しくはLICENSEをご覧ください。

---

_{DeXe Protocolのガバナンススタック向けの独立したオープンソース統合です。DeXe Networkとは提携していません。}