Soldefi Mcp

soldefi-mcp

一个 MCP（Model Context Protocol）服务，让 AI Agent 付费获取 Solana DeFi 风险情报——rug/honeypot 扫描、深度流动性池分析，以及经过刷量交易过滤的“真实最佳池”排名。每次付费调用都会自动使用你配置的钱包，以 USDC 支付 x402 小额款项（在 Solana 或 Base 上）。仅在调用成功时收费——格式错误的输入会被免费拒绝。

该服务调用托管的 Solana DeFi Intelligence API（默认地址为 https://soldefi.thomenz.me）。此软件包是轻量级的支付客户端桥接层；情报分析在服务端运行。

工具

工具	价格	功能
scan_honeypot	$0.005	按 mint 扫描 SPL 代币的 rug/honeypot 风险：mint/freeze 权限是否已放弃？Token-2022 转账税、最大持有者集中度，以及实时 Jupiter 买入→卖出往返交易，作为代币在扫描时可卖出的有力信号（可识别大多数 honeypot）。返回 0–100 风险评分，以及 AVOID/CAUTION/LOW RISK 判定。
analyze_pools	$0.015	深度分析 Raydium/Orca/Meteora/pumpswap 上的流动性池：真实手续费 APR、刷量交易风险、池龄、TVL、代币 rug 判定，以及真实的 Jupiter 滑点阶梯（$100/$1k/$10k）。推荐风险调整后表现最佳的池。
top_pools	$0.02	真实的 Solana DEX 最佳池——过滤掉刷量交易/虚假交易量池，再按风险调整后的手续费收益对其余池排名，并提供 excluded 列表，说明排除了哪些池及原因。
check_lp_status	$0.005	流动性持久性 / rug pull 风险敞口：池（TVL、池龄、DEX）、最大池深度、已销毁供应量占比，以及 mint/freeze 权限是否仍有效。返回 0-100 流动性风险评分及判定（DURABLE/SHAKY/FRAGILE/RUG-PRONE）。
check_deployer	$0.01	部署者信誉：创建者钱包地址、创建者剩余持仓比例、钱包年龄和代币年龄。判定会标记新建钱包、内部人士持仓过重以及刚创建的代币。
can_i_sell	$0.003	按你的卖出规模实时检查可卖性：通过实时 Jupiter 买入→卖出往返交易，模拟卖出指定美元金额的 Solana 代币，并报告收回的 USDC、实际卖出价格影响以及税费/摩擦损失。
check_exit_risk	$0.015	我能退出吗？代价是多少？ 将 Birdeye 聪明资金流向（鲸鱼 24 小时净买入/卖出、捆绑买入者/狙击手操纵标签、1 小时卖压、持有者数量）与实时 Jupiter 退出滑点阶梯（$1k/$10k）结合，得出 LOW/ELEVATED/HIGH 退出风险。卖出能力差距：鲸鱼是否正在流动性不足的订单簿中抛售，导致你被套住？
full_scan	$0.03	一次调用完成全面检查：将 honeypot + LP 持久性 + 部署者 + 退出风险检查整合为单一判定，并汇总为 overall {riskScore, riskLevel, verdict, topFlags}——比单独购买这四项更便宜（约 $0.035）。
scan_wallet_risk	$0.03	投资组合 rug 扫描：读取钱包中的 SPL 持仓，并对每项持仓运行完整 honeypot/rug 扫描（最多 10 项），返回每种代币的风险以及应退出哪些 mint。
scan_honeypot_batch	$0.02	批量 rug/honeypot 扫描：一次付费调用最多提交 10 个 Solana 代币 mint，并获取每种代币完整的 honeypot 判定（比逐个扫描更便宜）。
build_guarded_swap	$0.001 + 0.5%	在 rug 检查前置的情况下，构建可供签名的 Jupiter 兑换交易：如果你要买入的代币判定结果为严重风险，则返回判定结果，不生成交易。返回未签名的版本化交易——由你的钱包签名，本服务绝不会托管资金。0.5% 的平台费用仅适用于卖出兑换为 USDC/SOL（买入免手续费），并包含在你签名的交易中。
validate_mint	免费	在本地检查 base58 mint 地址格式。不收费。

安装和配置

将其添加到你的 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>"
      }
    }
  }
}

你也可以选择使用 Base 付款，而不是使用 Solana（或在此基础上同时使用 Solana），方法是设置 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 开发网）。
SOLANA_RPC_URL	—	可选的 RPC，用于构建 Solana 付款（例如 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