mcpField
V
VaultPilot MCP

VaultPilot MCP

ローカル
github.com金融データ312 週間前に更新

VaultPilot MCP について

VaultPilot MCPは、AIエージェント向けのセルフカストディ型DeFiサーバーです。EVM、TRON、Solana、Bitcoin、Litecoinの資産確認と取引準備に対応し、取引はLedgerで署名して秘密鍵をデバイス内に保ちます。

主な機能

  1. 01クロスチェーン資産とポジションの確認
  2. 02DeFiのステーキング、交換、ブリッジ
  3. 03Ledgerによる取引署名
  4. 04コントラクトと取引のリスク確認
  5. 05BitcoinとLitecoinのツール

活用シーン

  1. 01複数チェーンの残高とDeFiポジションの確認
  2. 02交換やステーキング操作の準備と署名
  3. 03署名前の取引詳細の確認

MCP 対応

MCPクライアントに資産、ポジション、セキュリティ、取引のツールを提供します。stdioクライアントに対応し、取引はWalletConnectまたはUSB HID経由でLedgerが署名します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"szhygulin-vaultpilot": {
"command": "npx",
"args": [
"-y",
"vaultpilot-mcp"
],
"env": {
"ETHEREUM_RPC_URL": "<ETHEREUM_RPC_URL>",
"ARBITRUM_RPC_URL": "<ARBITRUM_RPC_URL>",
"POLYGON_RPC_URL": "<POLYGON_RPC_URL>",
"BASE_RPC_URL": "<BASE_RPC_URL>",
"RPC_PROVIDER": "<RPC_PROVIDER>",
"RPC_API_KEY": "<RPC_API_KEY>",
"ETHERSCAN_API_KEY": "<ETHERSCAN_API_KEY>",
"ONEINCH_API_KEY": "<ONEINCH_API_KEY>",
"WALLETCONNECT_PROJECT_ID": "<WALLETCONNECT_PROJECT_ID>",
"VAULTPILOT_DEMO": "<VAULTPILOT_DEMO>"
}
}
}
}
起動コマンドnpx -y vaultpilot-mcp
設定が必要な環境変数
ETHEREUM_RPC_URLCustom Ethereum RPC endpoint (alternative to RPC_PROVIDER + RPC_API_KEY).
ARBITRUM_RPC_URLCustom Arbitrum RPC endpoint.
POLYGON_RPC_URLCustom Polygon RPC endpoint.
BASE_RPC_URLCustom Base RPC endpoint.
RPC_PROVIDERRPC provider name: 'infura' or 'alchemy'. Used together with RPC_API_KEY.
RPC_API_KEYシークレットAPI key for the chosen RPC_PROVIDER.
ETHERSCAN_API_KEYシークレットEtherscan API key for contract verification lookups.
ONEINCH_API_KEYシークレット1inch Developer Portal API key. Enables 1inch quote comparison in get_swap_quote.
WALLETCONNECT_PROJECT_IDシークレットWalletConnect Cloud project ID. Required for Ledger Live signing via WalletConnect.
VAULTPILOT_DEMOSet to 'true' to enable demo mode — no Ledger required, real chain RPC reads, signing-class tools either refuse or return simulated-broadcast envelopes. See `set_demo_wallet` and `exit_demo_mode` tools for the full demo flow.

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmvaultpilot-mcp0.14.4

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

VaultPilot MCP

npm version license node

AI エージェントのためのセルフカストディ型 DeFi です。エージェントが提案し、Ledger でユーザーが承認します。エージェント、MCP、ホストがすべて侵害される脅威モデルを想定して設計されています。信頼するのはデバイスのみで、秘密鍵がデバイスの外に出ることはありません。

VaultPilot MCP のデモ

Ethereum、Arbitrum、Polygon、Base、Optimism、TRON、Solana、Bitcoin、Litecoin のオンチェーンポジションを読み取り、トランザクションを準備できます。対応プロトコルは、EVM 上の Aave V3、Compound V3、Morpho Blue、Uniswap V3(スワップ+LP 操作)、Curve、Lido、EigenLayer、Rocket Pool、Safe(Gnosis)マルチシグ、Solana 上の MarginFi、Kamino、Marinade、Jito、TRON 上の SunSwap に加え、LiFi(EVM+EVM↔Solana+TRON+BTC のスワップ/ブリッジ)と Jupiter v6(Solana スワップ)です。EVM の見積もりを照合するオプションとして 1inch も利用できます。EVM の署名には WalletConnect → Ledger Live を使用します。TRON、Solana、Bitcoin、Litecoin の署名は、USB HID でデバイスに直接送信します(現在、Ledger Live の WalletConnect ブリッジはこれらの名前空間に対応していません)。Claude Code(CLI/ターミナル)、Cursor、および stdio 経由の MCP 互換クライアントで動作します。Claude.ai チャット(ウェブ版+ネイティブデスクトップアプリ)にはホスト型 MCP エンドポイントが必要です — ロードマップに記載されています。まだリリースされていません。

エージェントの方へ:AGENTS.md をお読みください。Claude Code/Cursor/MCP 対応エージェントに貼り付ける 1 行プロンプト:

AGENTS.md に従って、https://github.com/szhygulin/vaultpilot-mcp から VaultPilot MCP をインストールしてください。

機能

  • ポートフォリオ — クロスチェーン残高、DeFi ポジションの集約、USD 合計、NFT コレクション(EVM+Helius DAS 経由の Solana)、ウォレット単位の損益(mtd/ytd/30d/7d/1d)、日次ブリーフィング
  • ポジション — Aave、Compound、Morpho、Uniswap V3 LP、Curve、MarginFi、Kamino、Safe(Gnosis)マルチシグ、複数プロトコルのヘルスファクターアラート、清算リスクのシミュレーション
  • ステーキング — Lido(ステーク/アンステーク/stETH↔wstETH のラップ)+EigenLayer+Rocket Pool(EVM)、TRON Stake 2.0(凍結/凍結解除/投票/請求)、Solana(Marinade、Jito、ネイティブの委任/無効化/引き出し)
  • スワップ+ブリッジ — LiFi(EVM+EVM↔Solana+TRON+BTC のルート、オプションの 1inch 照合)、Jupiter v6(Solana)、Uniswap V3 直接利用、Curve、SunSwap(TRON)
  • 実行 — 対応するすべてのプロトコルの準備/署名+ネイティブ通貨/トークンの送金、ERC-20 の承認+取り消し、WETH のラップ/アンラップ、任意の検証済みコントラクト呼び出しに対応する prepare_custom_call のエスケープハッチ。Solana の送金では、ウォレットごとの耐久性のあるノンスアカウントを使用するため、Ledger の確認が約 60 秒のブロックハッシュ有効期間と競合しません。Solana の各準備処理では simulateTransaction によるゲートチェックを実行し、プログラムレベルのリバートをブロードキャスト時ではなく準備時に検出します。
  • Bitcoin+Litecoin — ネイティブ SegWit+Taproot の送金、BIP-125 の RBF 手数料引き上げ、PSBT マルチシグ(結合/署名/確定)、BIP-137 メッセージ署名、mempool.space による手数料推定、フォレンジックなチェーン読み取り(フォーク、メンプールの調査、手数料パーセンタイル)に対応するオプションの Bitcoin Core/Litecoin Core RPC
  • セキュリティ — コントラクト検証、アップグレード可能性のチェック、特権ロールの列挙、DefiLlama に基づくリスクスコア、デバイス上での Ledger 認証+ファームウェアバージョンの固定、バイト列と意図を別の LLM で照合する verify_tx_decode、署名済みのオンディスク連絡先/アドレス帳
  • ユーティリティ — ENS 解決、シンボルからコントラクトへの resolve_token レジストリ、トークン残高、アローアンスの列挙、トランザクションステータス、事後デコード用の explain_tx、レンディング+LST アダプター間の compare_yields
  • デモモード — RPC キー/Ledger/設定ファイルなしで初めて利用するための、厳選されたペルソナ(whale/defi-degen/stable-saver/staking-maxi)

セキュリティモデル

侵害モデル:AI エージェント、MCP サーバー、ホストコンピューターはすべて、攻撃者に制御されている可能性があります。信頼できるのは Ledger だけです。各レイヤーをまたいで、すべてのトランザクションが暗号学的に結び付けられているため、改ざん(受取人の差し替え、スワップルートの書き換え、承認の紛れ込み)は、署名する前にデバイス画面上で検知できます。

user-intent ──► agent ──► MCP server ──► WalletConnect / USB-HID ──► Ledger Live / host ──► Ledger device

多層防御:サーバー側の prepare↔send フィンガープリント、独立した 4byte.directory セレクターチェック、エージェント側の ABI デコードと署名前ハッシュ再計算、デバイス上でのクリア署名またはブラインド署名ハッシュの照合、WalletConnect セッショントピックのクロスチェック、previewToken/userDecision ゲート、高額なワークフローにおけるセカンド LLM によるクロス検証用の get_verification_artifact。脅威モデル全体、防御策の表、残存リスク、検証手順については、SECURITY.md を参照してください。

エージェント側の強化(強く推奨)

侵害されたサーバーは、MCP 独自の CHECKS PERFORMED ディレクティブを気付かれないように省略できます。MCP の応答に関係なく、エージェントに暗号学的完全性の不変条件を適用させるため、コンパニオンの vaultpilot-security-skill をインストールしてください。これにより、バイト列のデコード、ディスパッチ先の許可リスト、ハッシュ再計算、チェーンの明示必須、ブリッジ受取人のクロスチェック、承認クラスの提示、ハードトリガー操作でのセカンド LLM の必須化、セット単位の意図検証、永続的なバインディングの信頼できる情報源を適用します。

git clone https://github.com/szhygulin/vaultpilot-security-skill.git \
  ~/.claude/skills/vaultpilot-preflight

Claude Code を再起動してください。スキルファイルの SHA-256 はサーバーのソースで固定されています。ディスク上での改ざんやプラグインの競合があると、integrity check FAILED と表示されます。

会話形式の /setup(任意)

現在の設定を検出し、必要なキーだけを収集するチャット形式のオンボーディングを利用するには、コンパニオンの vaultpilot-setup-skill をインストールしてください。

git clone https://github.com/szhygulin/vaultpilot-setup-skill.git \
  ~/.claude/skills/vaultpilot-setup

再起動してから、/setup と入力してください。

対応チェーン

EVM — Ethereum、Arbitrum、Polygon、Base、Optimism。Lido の読み取りは Ethereum と Arbitrum に対応し、Lido の書き込みは Ethereum のみに対応します。EigenLayer、Morpho Blue、Rocket Pool は Ethereum のみです。Compound V3、Aave V3、Uniswap V3、LiFi、Safe マルチシグは5つすべてのチェーンに対応します。プロトコルごとにアドレスの対応状況は異なります。プロトコルがデプロイされていないチェーンでは、リーダーは適切に早期終了します。

TRON — TRX と標準 TRC-20 ステーブルコイン(USDT、USDC、USDD、TUSD)、Stake 2.0 の凍結/凍結解除/出金期限後の凍結解除、投票報酬の請求、SunSwap(同一チェーン上での TRX↔TRC-20 スワップ)、LiFi 経由の TRON↔EVM ブリッジに対応します。レンディング/LP には対応していません(Aave/Compound/Morpho/Uniswap はデプロイされていません)。pair_ledger_tron を使って、セッションごとに一度ペアリングしてください。

Solana — SOL と SPL の残高、MarginFi と Kamino のレンディング、SOL 相当額で評価した Marinade/Jito/ネイティブのステークアカウントの読み取り、Jupiter v6 の見積もり、Helius DAS の NFT ポートフォリオに対応します。書き込みでは、SOL/SPL の送金、MarginFi と Kamino の供給/引き出し/借入/返済、Jupiter のスワップ、Marinade のステークと即時アンステーク、Jito ステークプールへの預け入れ、ネイティブ SOL のデリゲート/無効化/引き出し、LiFi 経由の EVM↔Solana ブリッジに対応します。ウォレットごとの耐久ノンスアカウント(約 0.00144 SOL の賃料。回収可能)が、Ledger の確認中にブロックハッシュが期限切れになることから送信を保護します(prepare_solana_nonce_init/_close)。SPL/MarginFi/Kamino/Jupiter/Jito はメッセージハッシュに対してブラインド署名を行います。Solana アプリの設定で Allow blind signing を有効にしてください。ネイティブ SOL の送金はクリア署名を行います。pair_ledger_solana を使って、セッションごとに一度ペアリングしてください。

Bitcoin + Litecoin — Esplora(mempool.space/litecoinspace.org)経由で、残高、UTXO、手数料見積もり、トランザクション履歴を読み取ります。ネイティブ SegWit と Taproot による送信、BIP-125 の RBF 手数料引き上げ、マルチシグ PSBT(結合/署名/確定)、BIP-137 のメッセージ署名、LiFi 経由の BTC→EVM/Solana スワップに対応します。オプションの Bitcoin Core/Litecoin Core JSON-RPC を使うと、Esplora では提供できないフォレンジックツール(チェーン先端、ブロック統計、メンプール概要)が利用可能になります。セットアップについては INSTALL.md §9 を参照してください。pair_ledger_btc/pair_ledger_ltc を使って、一度ペアリングしてください。

Ledger Live の WalletConnect ブリッジは tron: 名前空間に対応しておらず(2026-04-14 に確認)、Solana アカウント(2026-04-23 に確認)や BTC/LTC 名前空間も公開しません。そのため、これらの経路では USB HID を使用します。プロトコルがデプロイされていないチェーンでは、リーダーは適切に早期終了します。

ロードマップ

ROADMAP.md。

ツール

読み取り/Ledger のペアリング/準備/署名+送信/検証/診断のカテゴリにまたがる約190のツールがあります。主なツールを以下に示します。各ツールには Zod 入力スキーマと詳細な説明があります。正式な一覧については、MCP サーバーの tools/list を照会してください。

ポートフォリオ+ポジション(読み取り専用):

  • get_portfolio_summary、get_portfolio_diff、get_pnl_summary、get_daily_briefing — クロスチェーンの USD 集計。tronAddress / solanaAddress は任意で指定でき、指定すると該当チェーンも集計に含まれます
  • get_lending_positions(Aave)、get_compound_positions、get_morpho_positions、get_marginfi_positions、get_kamino_positions、get_curve_positions、get_safe_positions — プロトコルごとのポジションとヘルスファクター
  • get_lp_positions — Uniswap V3 の LP と IL の推定値
  • get_staking_positions、get_staking_rewards、estimate_staking_yield — Lido、EigenLayer、Rocket Pool
  • get_solana_staking_positions — Marinade、Jito、およびネイティブのステークアカウント列挙。アクティベーション状況と SOL 換算評価額を含みます
  • get_tron_staking、list_tron_witnesses — TRON Stake 2.0 の状態と SR リスト
  • get_nft_portfolio(EVM + Solana DAS)、get_nft_collection、get_nft_history、get_nft_listings(EVM)
  • get_btc_balance / _balances / _account_balance / _multisig_balance / _multisig_utxos / _tx_history / _fee_estimates、get_ltc_balance — Esplora 経由で BTC + LTC の情報を読み取ります
  • get_compound_market_info — ウォレット不要の Comet スナップショット
  • get_health_alerts、simulate_position_change — 複数プロトコルに対応した清算リスクツール
  • compare_yields — Aave / Compound / Morpho / Marinade / Jito / Kamino-lend / MarginFi のレンディング APR を順位付けします
  • get_marginfi_diagnostics — バンドルされた SDK がスキップしたバンクと、その根本原因

トークン、価格、履歴:

  • get_token_balance、get_token_price、get_token_metadata、get_token_allowances、get_coin_price — EVM/TRON/Solana 上の残高と DefiLlama の価格。get_token_metadata は EIP-1967 プロキシを検出します
  • get_transaction_history — 複数ソースを統合したトランザクションリーダー(外部 / ERC-20 / 内部 / Solana program_interaction)。4byte でデコードしたメソッドと過去の USD 価格を含みます
  • get_transaction_status — ハッシュでトランザクションの取り込み状況を確認します
  • explain_tx — 過去のトランザクションを事後デコードします
  • resolve_token、resolve_ens_name、reverse_resolve_ens

フォレンジック向けチェーン読み取り(Bitcoin/Litecoin Core RPC が必要):

  • get_btc_block_tip / _block_stats / _blocks_recent / _chain_tips / _mempool_summary、および同等の get_ltc_*
  • build_incident_report、get_market_incident_status — Compound/Aave の一時停止と利用率のスキャン、および BTC/LTC のチェーン先端 / メンプール異常の一括レポート

見積もりとセキュリティシグナル:

  • get_swap_quote(LiFi、EVM)、get_solana_swap_quote(Jupiter v6)
  • check_contract_security、check_permission_risks、get_protocol_risk_score、get_contract_abi、read_contract
  • simulate_transaction — EVM の eth_call プレビュー(Solana に相当する機能は preview_solana_send 内で実行されます)
  • verify_tx_decode、get_verification_artifact、get_tx_verification — 2 つ目の LLM による相互検証と、15 分 TTL のハンドル再発行(詳細)

診断:

  • get_solana_setup_status — nonce と MarginFi アカウント PDA を調査します
  • get_vaultpilot_config_status — ローカル設定の診断(RPC ソース、キーの有無、ペアアカウント数、WC トピックのサフィックス、スキルの状態)。ブール値と件数のみで、秘密の値は含まれません
  • get_ledger_device_info、get_ledger_status、verify_ledger_attestation / _firmware / _live_codesign — デバイスとセッションの検出、デバイス上のアテステーション、ファームウェアバージョンの固定

連絡先と読み取り専用共有:

  • add_contact / remove_contact / list_contacts / verify_contacts — ~/.vaultpilot-mcp/contacts.json に保存される、Ledger 署名付きのローカルアドレス帳
  • generate_readonly_link / import_readonly_token / list_readonly_invites / revoke_readonly_invite — スコープを限定した読み取り専用のポートフォリオリンクを発行します
  • share_strategy / import_strategy — 匿名化されたポートフォリオスナップショット

実行(Ledger 署名):

  • pair_ledger_live(EVM/WC)、pair_ledger_tron / _solana / _btc / _ltc(USB HID)
  • prepare_aave_*、prepare_compound_*、prepare_morpho_* — EVM レンディング(供給/借入/出金/返済)
  • prepare_lido_stake / _unstake / _wrap / _unwrap(stETH↔wstETH)、prepare_eigenlayer_deposit、prepare_rocketpool_stake / _unstake
  • prepare_swap(LiFi)、prepare_native_send、prepare_token_send、prepare_token_approve、prepare_revoke_approval、prepare_weth_unwrap
  • prepare_uniswap_swap — 直接 V3 スワップ、同一チェーンでの実行。100/500/3000/10000 bps から手数料ティアを自動選択します。ユーザーが Uniswap を指定した場合にのみ使用し、それ以外は LiFi を優先します
  • prepare_uniswap_v3_mint / _increase_liquidity / _decrease_liquidity / _collect / _burn / _rebalance — LP 操作の動詞をすべて網羅
  • prepare_curve_swap、prepare_curve_add_liquidity
  • prepare_safe_tx_propose / _approve / _execute、submit_safe_tx_signature — Safe マルチシグの提案フロー
  • prepare_custom_call — 任意の検証済みコントラクト呼び出し用のエスケープハッチ(acknowledgeNonProtocolTarget: true ゲート。設計上、正規ディスパッチの許可リストを迂回します)
  • prepare_tron_* — ネイティブおよび TRC-20 の送金、WithdrawBalance、Stake 2.0、投票、報酬の受け取り、TRC-20 の承認、LiFi スワップ、SunSwap スワップ(prepare_sunswap_swap)
  • prepare_solana_nonce_init / _close — 永続ノンス PDA の初回セットアップ/解除
  • prepare_solana_native_send、_spl_send(ATA 作成を自動的に含む)、prepare_solana_swap(Jupiter)、prepare_solana_lifi_swap
  • prepare_marginfi_init、_supply、_withdraw、_borrow、_repay
  • prepare_kamino_init_user、_supply、_withdraw、_borrow、_repay
  • prepare_marinade_stake / _unstake_immediate(手数料が適用されます。アンステークチケットを使う遅延パスは未対応)、prepare_jito_stake(ステークのみ。アンステークは未対応)、list_solana_validators
  • prepare_native_stake_delegate / _deactivate / _withdraw — ネイティブ SOL ステーキング
  • prepare_btc_send、prepare_btc_rbf_bump、prepare_btc_multisig_send、register_btc_multisig_wallet / unregister_btc_multisig_wallet、combine_btc_psbts、sign_btc_multisig_psbt、finalize_btc_psbt、sign_message_btc、prepare_btc_lifi_swap、rescan_btc_account
  • prepare_litecoin_native_send、sign_message_ltc、rescan_ltc_account
  • preview_send(EVM)— ガスを固定し、事前照合用の LEDGER BLIND-SIGN HASH を出力し、previewToken を発行します。すべての EVM prepare_* と send_transaction の間で必須です
  • preview_solana_send — ノンス/ブロックハッシュを固定し、デバイス上での照合用に Message Hash を計算して、シミュレーションを実行し、CHECKS PERFORMED を出力します。すべての prepare_solana_* と send_transaction の間で必須です
  • send_transaction — Ledger に転送します(EVM は WC 経由、TRON/Solana/BTC/LTC は USB HID 経由)

メタ:

  • request_capability — 不足している機能について GitHub イシューを起票します。デフォルトでは入力済み URL を返します(自動送信なし)。レート制限は 1 時間あたり 3 回です
  • set_etherscan_api_key、set_helius_api_key、set_demo_wallet、exit_demo_mode、get_demo_wallet、get_update_command — ランタイム設定

要件

  • Node.js ≥ 18.17
  • 設定不要の読み取り: PublicNode(EVM)と Solana のパブリックメインネットを使用します。レート制限はありますが、初回の利用や軽い用途には十分です。
  • 実運用: 環境変数または vaultpilot-mcp setup を使って、カスタム RPC(Infura / Alchemy / Helius / QuickNode / Triton)を設定します。
  • オプションのキー(必要に応じて入力を求められます):Etherscan、1inch(スワップ見積もりの比較が可能になります)、WalletConnect プロジェクト ID(EVM の Ledger 署名に必須)、TronGrid(匿名アクセスの上限である約 15 リクエスト/分を引き上げます)。
  • TRON/Solana の署名: Tron/Solana アプリをインストールした Ledger に USB HID でアクセスできる必要があります。Linux:Ledger の udev ルールをインストールしてください(vaultpilot-mcp setup が正確な 1 行のコマンドを表示します)。Debian/Ubuntu では、node-hid のコンパイルに sudo apt install libudev-dev build-essential も必要です。

インストール

3つの方法があります。詳しい手順、MCP クライアントの接続、Gatekeeper / SmartScreen の対処、更新 / アンインストールについては INSTALL.md をご覧ください。

方法概要
同梱バイナリ(Node 不要)最新リリースをダウンロードし、chmod +x を実行してから <binary> setup を実行します。
npm からnpm install -g vaultpilot-mcp && vaultpilot-mcp setup
ソースからgit clone https://github.com/szhygulin/vaultpilot-mcp.git && cd vaultpilot-mcp && npm install --legacy-peer-deps && npm run build && npm run setup

セットアップ

npm run setup

RPC プロバイダーを選択し、キーを検証し、必要に応じて Ledger Live をペアリングして、~/.vaultpilot-mcp/config.json に書き込みます。環境変数は設定を上書きします。

デモモード

RPC キー、Ledger のペアリング、ウィザードなしで試せます。

claude mcp add vaultpilot-mcp --env VAULTPILOT_DEMO=true -- npx -y vaultpilot-mcp

--demo は同等の CLI フラグです。明示的な環境変数が優先されるため、VAULTPILOT_DEMO=false を指定すれば、スクリプトからの実行で確実にオプトアウトできます。

  • 読み取りは実際の RPC に対して実行されます。すべてのウォレットは、厳選された公開ペルソナ(whale、defi-degen、stable-saver、staking-maxi)です。
  • send_transaction はシミュレーションエンベロープを返します。未署名のトランザクションで simulate_transaction を実行してリバートを検出しますが、署名もブロードキャストも行いません。
  • pair_ledger_*、request_capability、sign_message_* は一切拒否されます。ペルソナが選択されていない場合、署名クラスのツールは set_demo_wallet を示す構造化エラーを返して拒否されます。
  • 前提条件が状態変更である複数ステップのフロー(例:prepare_solana_nonce_init → marinade_stake)は、エンドツーエンドでリハーサルできません。シミュレーションによる送信ではチェーンの状態が変化しないためです。MCP はエージェントループの罠を検出すると、1回限りのヒントを表示します。

get_demo_wallet はペルソナ、アドレス、rehearsableFlows を一覧表示します。set_demo_wallet({ persona }) でペルソナを有効にします。状態はプロセス内に限られます。exit_demo_mode は、恒久的なセットアップに向けた引き継ぎガイドを返します。デモは初回利用のための足場であり、サンドボックスではありません。仮想チェーンのオーバーレイはありません。

複数ツールの同時実行時に Solana RPC のスロットリングを避けるには、実行時に Helius キーを指定してください:set_helius_api_key({ key })。デモモードでは、公開 RPC のスロットリングエラーが10回発生すると、事前に通知します。

Claude Code(CLI)/ Cursor / Claude Desktop での使用

vaultpilot-mcp setup はインストール済みのクライアントを検出し、それぞれに vaultpilot-mcp を登録します(既存の設定は <file>.vaultpilot.bak にバックアップされます)。プロジェクト / ワークスペースごとの設定はスキップされます。ウィザードは任意の CWD から実行されるためです。手動で接続する方法や、クライアントごとの設定パスについては、INSTALL.md §5 をご覧ください。

Claude.ai のチャットに関する制限。 ウィザードからインストールしたローカル stdio MCP は Claude.ai のネイティブデスクトップアプリに正常に登録されますが、ホスト環境のアウトバウンド HTTP 許可リストにより、チェーン RPC プロバイダー(PublicNode、公開 Solana mainnet、Alchemy、Helius など)がブロックされます。MCP は初期化され、ツール呼び出しを処理しますが、外部 RPC にアクセスする読み取りはすべて 403 / 「Host not in allowlist」で失敗します。同じ制限は、Claude.ai のクラウドサンドボックス内で実行する Claude Code にも適用されます。現在利用可能:ターミナルで実行する Claude Code CLI、Cursor、アウトバウンド HTTP が制限されていないホスト上の Claude Desktop。今後の予定:ホスト型 MCP エンドポイント(ロードマップ、未リリース)が、Claude.ai のチャットにネットワーク制限のないバックエンドを提供します。TRON / Solana / Bitcoin / Litecoin の USB-HID 署名にはローカルの Ledger が必要なため、いずれの場合もターミナル CLI / Cursor での利用となります。

環境変数

対応するフィールドが ~/.vaultpilot-mcp/config.json にある場合、すべて任意です。環境変数が優先されます。

  • ETHEREUM_RPC_URL、ARBITRUM_RPC_URL、POLYGON_RPC_URL、BASE_RPC_URL、SOLANA_RPC_URL — カスタム RPC エンドポイント
  • RPC_PROVIDER(infura | alchemy)と RPC_API_KEY — カスタム URL の代替
  • ETHERSCAN_API_KEY、ONEINCH_API_KEY、TRON_API_KEY、WALLETCONNECT_PROJECT_ID
  • RPC_BATCH=1 — JSON-RPC バッチ処理を有効化します(デフォルトでは無効です。多くのパブリックエンドポイントはバッチ POST を正しく処理できません)
  • VAULTPILOT_ALLOW_INSECURE_RPC=1 — https/プライベート IP の RPC チェックを無効にします(ローカルの anvil/hardhat のみ)
  • VAULTPILOT_FEEDBACK_ENDPOINT — request_capability の直接 POST に使用する任意の https プロキシです。クライアントは認証を行いません。プロキシで必ず認証してください。
  • VAULTPILOT_SKILL_MARKER_PATH — プリフライトスキルの通知を抑制します(オプトインする読み取り専用ユーザー向け)
  • VAULTPILOT_DISABLE_SKILL_AUTOINSTALL=1 — 付属スキルの初回実行時の遅延 git clone をスキップします(エアギャップ環境/外部への接続がない環境向け)
  • VAULTPILOT_DEMO=true — デモモードを有効にします。リテラルの "true" のみ受け付け、それ以外の値は拒否されます
  • VAULTPILOT_DISABLE_UPDATE_CHECK=1 — セッションごとに一度行われる registry.npmjs.org の更新チェックをスキップします(エアギャップ環境向け)

開発

npm run dev      # tsc --watch
npm test         # vitest run
npm run test:watch

貢献

プルリクエストを歓迎します。初めてプルリクエストを送る際に、CLA Assistant ボットからコントリビューターライセンス契約への署名を求められます。一度署名すれば、以降のすべてのプルリクエストに適用されます。この CLA により、プロジェクトはあなたの貢献を再ライセンスする権利を得ます。署名がない場合、2030 年の BUSL-1.1 から Apache 2.0 への自動移行が滞ります。リポジトリのオーナーと Dependabot は対象外です。

ライセンス

Business Source License 1.1 — LICENSEを参照してください。

  • 個人によるセルフカストディ利用は無料です。自身のために行うイールド運用/スワップ/貸付/ステーキングも含まれます。
  • 組織内での利用は無料です。
  • ホステッドサービスおよび組み込みによる再配布には商用ライセンスが必要です — issue を作成するか、メンテナーにお問い合わせください。
  • **2030-04-26 に Apache 2.0 へ自動移行します。**各バージョンの制限は、リリースから 4 年後に失効します。
  • **バージョン 0.8.2 以下は引き続き MIT ライセンスです。**ライセンスの変更は v0.9.0 以降に適用されます。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。