Soldefi Mcp

soldefi-mcp

MCP（Model Context Protocol）サーバーです。AI エージェントに、Solana DeFi のリスクインテリジェンスへの有料アクセスを提供します。ラグ／ハニーポットのスキャン、流動性プールの詳細分析、ウォッシュトレードを除外した「真のベストプール」ランキングを利用できます。有料の呼び出しごとに、設定したウォレットを使って x402 のマイクロペイメント（USDC）が（Solana または Base 上で）自動決済されます。課金されるのは成功した場合のみです。不正な入力は無料で拒否されます。

デフォルトでは、ホスト型の Solana DeFi Intelligence API（https://soldefi.thomenz.me）に接続します。このパッケージは、決済クライアントと API をつなぐ薄いブリッジです。インテリジェンス処理はサーバー側で実行されます。

ツール

ツール	価格	機能
scan_honeypot	$0.005	ミントアドレスを指定して、SPL トークンのラグ／ハニーポットをスキャンします。ミント／フリーズ権限が放棄されているか、Token-2022 の送金税、上位保有者への集中度、さらにスキャン時点でトークンを売却できることを示す強いシグナルとして、Jupiter で実際に買って売る一連の取引を確認します（大半のハニーポットを検出できます）。0～100 のリスクスコアと、AVOID／CAUTION／LOW RISK の判定を返します。
analyze_pools	$0.015	Raydium／Orca／Meteora／pumpswap の流動性プールを詳細に分析します。実質的な手数料 APR、ウォッシュトレードのリスク、経過期間、TVL、トークンのラグ判定、Jupiter による実際のスリッページ段階（$100／$1k／$10k）を確認し、リスク調整後で最適なプールを推奨します。
top_pools	$0.02	本当に優れた Solana DEX プールを表示します。ウォッシュトレードや偽の取引高を持つプールを除外し、残りをリスク調整後の手数料利回りで順位付けします。除外されたプールとその理由を示す excluded リストも返します。
check_lp_status	$0.005	流動性の持続性とラグプルのリスクを確認します。プール（TVL、経過期間、DEX）、最大プールの深度、バーン済み供給量の割合、ミント／フリーズ権限がまだ有効かどうかを確認します。0～100 の流動性リスクスコアと判定（DURABLE／SHAKY／FRAGILE／RUG-PRONE）を返します。
check_deployer	$0.01	デプロイヤーの評判を確認します。作成者のウォレットアドレス、作成者が保有し続けている割合、ウォレットの経過期間、トークンの経過期間を返します。ウォレットが新しい、内部関係者の保有割合が高い、トークンが発行直後といった場合に判定で警告します。
can_i_sell	$0.003	指定した数量でリアルタイムの売却可能性を確認します。Solana トークンを指定した USD 額だけ保有している想定で、Jupiter で実際に買って売る一連の取引をシミュレーションし、回収できる USDC、実際の売却価格への影響、税金や摩擦による損失を報告します。
check_exit_risk	$0.015	売却して退出できるか、コストはいくらかを確認します。Birdeye のスマートマネーの動き（24 時間のクジラの純買い／売り、バンドラー／スナイパーによる操作タグ、1 時間の売り圧力、保有者数）と、Jupiter による実際の退出スリッページ段階（$1k／$10k）を組み合わせて、退出リスクを LOW／ELEVATED／HIGH で判定します。売却可能性の観点から、クジラが流動性の薄い板で売り抜け、あなたが身動きできなくなる状況がないかを確認します。
full_scan	$0.03	1 回の呼び出しで総合分析します。ハニーポット、LP の持続性、デプロイヤー、退出リスクをまとめ、集約された overall {riskScore, riskLevel, verdict, topFlags} を含む単一の判定を返します。4 つを個別に購入するより安価です（約 $0.035）。
scan_wallet_risk	$0.03	ポートフォリオのラグスキャンです。ウォレットの SPL 保有資産を読み取り、それぞれ（最大 10 ポジション）に対してハニーポット／ラグの完全スキャンを実行し、トークンごとのリスクと退出すべきミントを返します。
scan_honeypot_batch	$0.02	ラグ／ハニーポットの一括スキャンです。Solana トークンのミントを最大 10 件送信すると、1 回の有料呼び出しで各トークンの完全なハニーポット判定を取得できます（個別にスキャンするより安価です）。
build_guarded_swap	$0.001 + 0.5%	ラグチェックを組み込んだ、すぐに署名できる Jupiter スワップを構築します。購入するトークンの判定が重大なリスクを示す場合は、判定のみを返し、トランザクションは返しません。返されるのは未署名のバージョン付きトランザクションです。ウォレットが署名し、このサービスが資金を保管することはありません。プラットフォーム手数料 0.5% が適用されるのは USDC／SOL への売却時のみです（購入は手数料無料）。手数料は署名するトランザクションに含まれます。
validate_mint	無料	base58 のミントアドレス形式をローカルで確認します。支払いは不要です。

インストールと設定

MCP クライアント（Claude Code、Claude Desktop など）に追加してください。必要なのは支払い用ウォレットだけです。それ以外はすべて本番環境向けのデフォルト設定になっています。

{
  "mcpServers": {
    "soldefi": {
      "command": "npx",
      "args": ["-y", "soldefi-mcp"],
      "env": {
        "SOLANA_PRIVATE_KEY": "<base58-or-JSON-array secret key of a DEDICATED Solana wallet holding USDC>"
      }
    }
  }
}

Solana に加えて、または Solana の代わりに Base で支払うには、EVM_PRIVATE_KEY（0x…）を設定します。両方が設定されている場合、x402 レイヤーはサーバーの支払いチャレンジで提示された方の決済ネットワークを使用します。

環境変数

変数	デフォルト	備考
SOLANA_PRIVATE_KEY	—	支払い用 Solana ウォレットの base58 または JSON 配列形式の秘密鍵（32 バイトまたは 64 バイト）です。
EVM_PRIVATE_KEY	—	支払い用 Base ウォレットの 0x で始まる秘密鍵です。
SOLDEFI_BASE_URL	https://soldefi.thomenz.me	セルフホストする場合は、独自の Worker を指定します。
X402_NETWORK	base	base（メインネット → Solana メインネット）または base-sepolia（テストネット → Solana Devnet）です。
SOLANA_RPC_URL	—	Solana の支払いを作成するために使用する任意の RPC（例：Helius の URL）です。それ以外の場合はパブリックのデフォルトが使用されます。

🔐 セキュリティ： これらの鍵は実際の資金を管理します。残高の少ない専用ウォレットを使用し、個人用または財務用の鍵は絶対に使用しないでください。このプロセスの環境変数を読み取れるものは、そこから資金を支出できます。

ウォレットに必要なもの

• 呼び出しごとの支払いに使う、選択したチェーン上の少量の USDC。
• Solana では、支払い自体に少量の SOL は必要ありません（手数料はファシリテーターが負担します）。ただし、受け取り側には USDC トークンアカウントが必要です。ホスト型サービスではすでに用意されています。

開発

pnpm install
pnpm --filter soldefi-mcp build      # tsc → dist/
SOLANA_PRIVATE_KEY=… pnpm --filter soldefi-mcp dev   # run from source

ライセンス

MIT