solsentry/solsentry-mcp

# @solsentry/mcp [](https://www.npmjs.com/package/@solsentry/mcp) [](https://www.npmjs.com/package/@solsentry/mcp) [](./LICENSE) [](https://api.solsentry.app/health) **三种接口，一个包。** SolSentry —— 部署后的 Solana 威胁 情报 —— 以 MCP server、TypeScript SDK 和 Claude Skill bundle 的形式分发。 ## 这是什么 | 接口 | 使用场景 | 安装 | |---|---|---| | **MCP server** | AI agents (Claude Desktop、Cursor、Claude Code，任何 MCP client) | `npx @solsentry/mcp` | | **TypeScript SDK** | 不支持 MCP 的 TS 后端、机器人、钱包、dApps | `import { SolSentryClient } from "@solsentry/mcp/client"` | | **Skills bundle** | 支持 [Agent Skills 规范](https://agentskills.io) 的 Claude Code / Cursor | `npx skills add @solsentry/mcp` | 这三种方式都调用位于 `api.solsentry.app` 的公共 REST API。读取 端点无需 API key。 ### 实时系统快照 (2026年5月14日) - **56,159 次预测** · **88.8% 准确率** (已结算) · **93.2% 结算率** - **96.6% CRITICAL 精确度 · 98.9% HIGH 精确度** (607 个 FP 事件 / 231 个唯一 mint 在 CRITICAL 级别 —— 每个 FP 都是阈值边缘情况，完整审计见 `/v1/predictions/{mint}`) - **追踪了 6,352 个操作者** · **1,477 个连续部署者** · **21,711 个已确认的 rugs** · **7,968 个机器人集群** - 在单台 Hetzner VPS 上持续运行 **742 小时 mainnet**（约 31 天） - **多层 RPC 池**：Helius (DAS + Enhanced TX) + Alchemy + RPC Fast (tier-0 轮询，Frontier 2026) - **多源数据层**：Dune Sim、Covalent / GoldRush、Zerion、Arkham (实体图谱)、Nansen (钱包标签)、InsightX (持有者 + bundle)、Birdeye + DexScreener (价格 + 流动性)、Solscan + Jupiter (元数据) - **AI**：Anthropic Claude (多语种风险解释器，以 PT-BR 为主 + EN) - **隐私防护**：Cloak + Umbra (Frontier 2026 合作伙伴 —— 与防护无关的操作者过滤) - **x402 付费端点**：已准备好进行 mainnet 强制执行 - **Colosseum Frontier 2026** 提交 · [Arena 主页](https://arena.colosseum.org/projects/explore/solsentry-3) 这些数字每天会随着预测的结算而变化 —— 如需验证实时数据：`curl https://api.solsentry.app/v1/stats` ## 此仓库包含什么 ``` solsentry-mcp/ ├── src/ ← TypeScript source (MCP server + SDK) ├── skills/ │ └── solsentry-postdeploy/ ← 1 skill, 6 references (progressive disclosure) │ ├── SKILL.md orchestrator: when to load each reference │ └── references/ │ ├── threat-intel.md · generic risk lookup │ ├── counterparty.md · pre-CPI counterparty check │ ├── monitor.md · post-deploy program monitoring │ ├── forensics.md · post-incident drain trace │ ├── token-launch.md · pre-launch readiness for your own token │ └── cluster-graph.md · operator/bot network exploration └── docs/ ← public reference docs ├── risk-scoring.md · scoring methodology + thresholds ├── flags.md · canonical flag glossary ├── openapi.yaml · machine-readable REST spec └── x402-example.md · paid endpoint integration example ``` SolSentry 持续监控 Solana mainnet，并追踪连续的 rug pull 操作者、机器人集群以及恶意代币发布。数据每 30 秒刷新一次， 可供任何支持 MCP 或纯 HTTP 的客户端使用。 ## 快速开始 ``` npx @solsentry/mcp ``` ### Claude Desktop `claude_desktop_config.json`: ``` { "mcpServers": { "solsentry": { "command": "npx", "args": ["-y", "@solsentry/mcp"] } } } ``` ### Cursor / Claude Code `.mcp.json`: ``` { "mcpServers": { "solsentry": { "command": "npx", "args": ["-y", "@solsentry/mcp"] } } } ``` ## 工具 | 工具 | 用途 | |---|---| | `check_operator` | 钱包作为代币部署者的风险画像。包含 rug 次数、标签、风险等级。 | | `check_token` | 代币 mint 的风险画像。包含评分、标记、操作者历史、bundle 检测。 | | `get_top_operators` | 最恶劣的连续 rug 操作者排行榜。 | | `get_network_stats` | 全系统统计：扫描次数、准确率、操作者、集群。 | | `explain_risk` | 为任何地址（钱包或 mint）提供纯文本英文风险摘要。 | ## 风险等级 | 等级 | 标准 | |---|---| | `CRITICAL` | 10 次及以上已确认的 rug，或代币被确认为 rug | | `HIGH` | 5 次及以上已确认的 rug，或风险评分 ≥ 80 | | `MEDIUM` | 2 次及以上已确认的 rug，或风险评分 ≥ 50 | | `LOW` | 1 次已确认的 rug，或风险评分 > 0 | | `CLEAN` | 无 rug，包含已追踪的代币 | | `UNKNOWN` | 不在数据库中 | ## 配置 | 环境变量 | 默认值 | 用途 | |---|---|---| | `SOLSENTRY_API_URL` | `https://api.solsentry.app` | API 端点 | | `SOLSENTRY_API_KEY` | — | 用于认证端点的 Bearer token | ## TypeScript SDK 直接在您的 TypeScript 代码中使用 MCP server 所使用的同一 client： ``` import { SolSentryClient } from "@solsentry/mcp/client"; const sol = new SolSentryClient(); const op = await sol.get<{ risk_level: string; confirmed_rugs: number }>( "/v1/operator/4kxscuteRLQdNiTXA33YYsvywAPNA6DQTifswxjL5pH1", ); if (op.risk_level === "CRITICAL") { console.warn(`Serial rugger detected: ${op.confirmed_rugs} confirmed rugs`); } ``` 适用于交易机器人、钱包警告、dApp 签名前检查，以及 任何需要威胁情报但不使用 MCP 传输的后端。 ## REST API 此软件包的所有功能也可通过纯 HTTP 访问，无需安装： ``` curl https://api.solsentry.app/v1/stats curl https://api.solsentry.app/v1/operator/4kxscuteRLQdNiTXA33YYsvywAPNA6DQTifswxjL5pH1 curl https://api.solsentry.app/v1/top-operators?limit=5 ``` 完整端点参考：https://solsentry.app/docs/api-reference ## Drain-trace 端点 `/v1/drain-trace/{wallet}` 可追踪发生 rug 后的 SOL 流向，最多追踪 10 跳，覆盖 mixers、bridges 和 CEXs。需要带有额度的 API key。 对已验证的受害者免费 —— 如果该钱包曾收到过 SolSentry 发出的 drain alert，则对该钱包进行 drain-trace 是免费的。 ## 系统要求 - Node.js ≥ 18 ## 许可证 MIT ## 链接与联系方式 - **网站:** [solsentry.app](https://solsentry.app) - **X (项目):** [@solsentryai](https://x.com/solsentryai) - **Telegram:** [t.me/solsentryai](https://t.me/solsentryai) - **GitHub:** [github.com/solsentry](https://github.com/solsentry) - **邮箱:** `hello@solsentry.app` - **作者:** [Crash Diniz · @crashdiniz](https://x.com/crashdiniz)

标签：AI代理, API集成, Claude Desktop, GitHub, Go语言工具, IP 地址批量处理, MCP服务器, MITM代理, NPM包, OSV-Scalibr, REST API, Rug Pull检测, Solana, Solana生态, TypeScript, Web3安全, 人工智能, 僵尸集群, 加密货币诈骗检测, 区块链安全, 去中心化应用, 可观测性, 大语言模型工具, 威胁情报, 安全插件, 实时处理, 开发者工具, 数字资产保护, 智能合约风险, 暗色界面, 用户模式Hook绕过, 自动化攻击, 自动化监控, 钱包追踪, 链上数据分析, 零安装, 风控系统