mcpField
R
Recon Crypto MCP

Recon Crypto MCP

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

Recon Crypto MCP について

Recon Crypto MCPは、エージェントとLedger利用者向けのセルフカストディ型DeFi MCPサーバーです。マルチチェーンのポートフォリオを読み取り、秘密鍵をLedger内に保ったまま、デバイス承認用の取引を準備します。

主な機能

  1. 01マルチチェーンのポートフォリオとポジション参照
  2. 02DeFiのステーキング、スワップ、ブリッジ
  3. 03Ledgerで確認する取引署名
  4. 04コントラクトと取引のセキュリティ検査
  5. 05BitcoinとLitecoinのウォレット操作

活用シーン

  1. 01対応チェーンのDeFiポジションを確認
  2. 02スワップやステーキングを準備してLedgerで承認
  3. 03コントラクト権限と取引内容を調査
  4. 04BitcoinまたはLitecoinの送金やマルチシグを管理

MCP 対応

MCPサーバーは、ポートフォリオ、ポジション、セキュリティ、取引のツールをクライアントに提供します。Ledger署名用に操作を準備し、EVMではWalletConnect、TRON、Solana、Bitcoin、LitecoinではUSB HIDを使います。

設定

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

mcp.json · 共通設定
{
"mcpServers": {
"szhygulin-recon-crypto": {
"command": "npx",
"args": [
"-y",
"recon-crypto-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>"
}
}
}
}
起動コマンドnpx -y recon-crypto-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.

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

パッケージ
npmrecon-crypto-mcp0.3.1

ツール

44

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
chainsarrayいいえ
walletstringはい

詳細

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 チャット(Web+ネイティブデスクトップアプリ)にはホスト型 MCP エンドポイントが必要です。これはロードマップに掲載されていますが、まだリリースされていません。

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

Install VaultPilot MCP from https://github.com/szhygulin/vaultpilot-mcp following AGENTS.md.

機能

  • ポートフォリオ — クロスチェーン残高、DeFi ポジションの集計、USD 合計、NFT コレクション(Helius DAS 経由の EVM+Solana)、ウォレット単位の PnL(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 の証明+ファームウェアバージョンの固定、2 つ目の 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 ゲート、および高額フローでの 2 つ目の LLM によるクロス検証のための get_verification_artifact。脅威モデル、防御策の表、残存リスク、検証手順の全容については SECURITY.md を参照してください。

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

侵害されたサーバーは、MCP 独自の CHECKS PERFORMED 指示を黙って省略する可能性があります。MCP が何を伝えるかにかかわらず、エージェントが暗号学的完全性の不変条件を適用できるよう、付属の vaultpilot-security-skill をインストールしてください。バイト列のデコード、ディスパッチ先の許可リスト、ハッシュの再計算、チェーンの明示必須化、ブリッジ宛先のクロスチェック、承認クラスの提示、すべてのプレビューでの任意の 2 つ目の 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 を使ってセッションごとに1回ペアリングしてください。

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

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 では提供できないフォレンジックツール(チェーン先端、ブロック統計、mempool の概要)を利用できます。セットアップについては INSTALL.md §9 を参照してください。pair_ledger_btc/pair_ledger_ltc を使って1回ペアリングしてください。

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 — クロスチェーンの米ドル集計。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 とインパーマネントロスの推定
  • 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 でデコードしたメソッドと過去の米ドル価格も含まれます。
  • 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 — Ledger で署名されたローカルアドレス帳(~/.vaultpilot-mcp/contacts.json)
  • 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 が一度だけヒントを表示します。

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 メインネット、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

貢献

PR を歓迎します。初回の PR では、CLA Assistant ボットから貢献者ライセンス契約への署名を求められます。署名は今後のすべての PR に適用されます。CLA により、プロジェクトには貢献内容のライセンスを変更する権利が付与されます。署名がない場合、2030 年の BUSL-1.1 から Apache 2.0 への自動移行が滞ります。リポジトリの所有者と Dependabot は対象外です。

ライセンス

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

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

コメント

MCP は初めてですか?

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

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