VaultPilot MCP について
VaultPilot MCPは、AIエージェント向けのセルフカストディ型DeFiサーバーです。EVM、TRON、Solana、Bitcoin、Litecoinの資産確認と取引準備に対応し、取引はLedgerで署名して秘密鍵をデバイス内に保ちます。
主な機能
- 01クロスチェーン資産とポジションの確認
- 02DeFiのステーキング、交換、ブリッジ
- 03Ledgerによる取引署名
- 04コントラクトと取引のリスク確認
- 05BitcoinとLitecoinのツール
活用シーン
- 01複数チェーンの残高とDeFiポジションの確認
- 02交換やステーキング操作の準備と署名
- 03署名前の取引詳細の確認
MCP 対応
MCPクライアントに資産、ポジション、セキュリティ、取引のツールを提供します。stdioクライアントに対応し、取引はWalletConnectまたはUSB HID経由でLedgerが署名します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y vaultpilot-mcpETHEREUM_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 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。
詳細
VaultPilot MCP
AI エージェントのためのセルフカストディ型 DeFi です。エージェントが提案し、Ledger でユーザーが承認します。エージェント、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 を使用します。プロトコルがデプロイされていないチェーンでは、リーダーは適切に早期終了します。
ロードマップ
ツール
読み取り/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 Poolget_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_contractsimulate_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/_unstakeprepare_swap(LiFi)、prepare_native_send、prepare_token_send、prepare_token_approve、prepare_revoke_approval、prepare_weth_unwrapprepare_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_liquidityprepare_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_swapprepare_marginfi_init、_supply、_withdraw、_borrow、_repayprepare_kamino_init_user、_supply、_withdraw、_borrow、_repayprepare_marinade_stake/_unstake_immediate(手数料が適用されます。アンステークチケットを使う遅延パスは未対応)、prepare_jito_stake(ステークのみ。アンステークは未対応)、list_solana_validatorsprepare_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_accountprepare_litecoin_native_send、sign_message_ltc、rescan_ltc_accountpreview_send(EVM)— ガスを固定し、事前照合用のLEDGER BLIND-SIGN HASHを出力し、previewTokenを発行します。すべての EVMprepare_*と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_IDRPC_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 以降に適用されます。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。