XRPL Token Guard

XRPL Token Guard

询问 AI Agent 或语音助手“这个代币安全吗？”，即可获得坦诚且有依据的回答。

XRPL Token Guard 是一款开源的 MCP 服务。它使用实时、只读的主网数据检查 XRP Ledger 代币和钱包，并返回三项内容：

• 判定：高风险 / 谨慎 / 未发现风险信号 / 数据不足
• 判定依据：逐条指出对应的具体账本事实
• 一句话语音摘要：可直接用于 Alexa+ 或其他语音助手的文本转语音

它绝不会签名或发送交易，也不会索要密钥。

想进行比快速检查更深入的核查？

试试免费的托管演示，或浏览免费的代币证据页面。Launch Lab 提供代币报告，价格为 5 XRP、钱包检查，价格为 3 XRP，以及代币启动套件，价格为 10 XRP。选择付费报告前，可以先预览核查结果。这些是基于账本事实的核查，不构成买卖建议，也不保证安全；Token Guard 始终免费。

托管 MCP： https://cocoeatsai.com/area4/guard/mcp（Streamable HTTP）。托管演示支持输入问题和点击示例按钮；根据托管策略，目前已禁用麦克风输入。它是语音助手模拟器，并非实际的 Alexa 集成。

对于 Claude Desktop（claude_desktop_config.json）或 Cursor（.cursor/mcp.json），请使用以下命令构建本地副本，然后替换此配置中的绝对路径：

{"mcpServers": {
  "xrpl-token-guard": {"command": "node", "args": ["/absolute/path/to/xrpl-token-guard/dist/stdio.js"]}
}}

风险解读示例（非交易建议）：

You:    "Is this RLUSD real?"
Guard:  "Warning, high risk. This token calls itself RLUSD, but it is not the real Ripple USD.
         The real one comes from a different issuer. A matching name does not establish authenticity."

为什么要开发它

XRP Ledger 上的诈骗者会冒用知名名称。目前主网上有多个名为 RLUSD、但并非 Ripple 发行的代币。其中许多代币的发行方已被黑洞化；简单的检查工具会因无人能再铸造代币而将其评为“安全”。Token Guard 知道官方发行方是谁，会优先标记仿冒代币，并说明供应量被锁定并不代表仿冒品是真的。

回答必须简短到适合朗读，也必须具体到值得信赖。每条检查结果都包含精确的 message（供屏幕显示和 Agent 使用）以及 spoken（供语音朗读）。

工具

工具	回答的问题	账本调用
check_token_safety	“这个代币安全吗？”检查内容包括：仿冒 RLUSD/USDC/SOLO、仍可铸造或冻结代币或追回代币的发行方、全局冻结、转账手续费、未经验证或仅在启动平台上登记的域名、巨鲸持仓集中度（不含 AMM 池）、AMM 流动性不足，以及新近创建的发行方。	account_info、gateway_balances、amm_info、account_lines、account_tx
is_it_the_real_token	“这是真正的 RLUSD 吗？”根据已验证的官方发行方即时回答（每个发行方的链上域名都指向品牌官网）。	无
check_wallet_security	“我的钱包被黑了吗？”查找陌生人的常规密钥或多重签名签署者列表（典型的盗币设置），并将过去 7 天内的变更标记为紧急。	account_info、account_tx

此外还有一个提示词 voice_token_check，用于指导语音助手如何回答：用两句话说明判定和主要原因，不提供买卖建议。

每个工具都具备：

• readOnlyHint: true
• 一个 outputSchema，且每个响应都包含带类型的 structuredContent
• 一个便于人类阅读的文本块

代码会根据发行方的实际债务（不区分大小写）解析代币代码，因此查询“bigds”也能找到 $BIGDS。

运行

npm install
npm run build
npm start                 # Streamable HTTP on http://127.0.0.1:8787/mcp, voice demo on http://127.0.0.1:8787/
npm run stdio             # stdio transport for Claude Desktop / Claude Code / Cursor
npm test                  # 14 unit + end-to-end MCP tests (LIVE=1 adds a mainnet check)

传输方式： Streamable HTTP，MCP 协议 2025-11-25。

• 无状态：每个 POST /mcp 请求都会启动一个全新的服务，因此可横向扩展。
• JSON 响应。
• 速率限制：每个 IP 每分钟 60 个请求。
• 通过 ALLOWED_ORIGINS 设置 Origin 允许列表。
• GET /health 会报告传输方式和协议。

Docker：

# Web demo + Streamable HTTP (default target)
docker build -t xrpl-token-guard .
docker run --rm -p 8787:8787 xrpl-token-guard

# stdio MCP clients / Glama: keep stdin open; do not allocate a TTY
docker build --target stdio -t xrpl-token-guard:stdio .
docker run --rm -i xrpl-token-guard:stdio

对于使用默认镜像的 Glama 构建规范，请将 CMD 参数设置为 node dist/stdio.js。无需 API 密钥或钱包凭证。

Claude Desktop（claude_desktop_config.json）：

{ "mcpServers": { "xrpl-token-guard": { "command": "node", "args": ["/path/to/xrpl-token-guard/dist/stdio.js"] } } }

配置

环境变量	默认值	含义
XRPL_RPC_URLS	https://xrplcluster.com,https://s1.ripple.com:51234,https://s2.ripple.com:51234	公共 XRPL JSON-RPC 端点，按顺序尝试
HOST / PORT	127.0.0.1 / 8787	绑定地址
ALLOWED_ORIGINS	（任意）	/mcp 的逗号分隔 Origin 允许列表
TOKEN_GUARD_LINKS	on	如果存在，则添加指向代币免费账本证据页面的链接；off 会禁用此功能

语音演示（Alexa+ 风格模拟器）

打开 http://127.0.0.1:8787/ 并点击麦克风（Chrome），或输入文字。

• 此页面是一个小型 MCP 客户端，通过 Streamable HTTP 与 /mcp 通信。它会将问题转换为工具调用，并朗读 spoken_summary。
• 右侧面板会显示实时的 tools/call 请求和结果。
• /?demo=1 会播放带字幕的脚本演示，便于录屏。

判定方式

严重程度	示例	影响
⛔ 高	冒充官方代币、已启用 Global Freeze、已启用 clawback、发行方不存在、未发行任何代币	判定为高风险
⚠️ 警示	发行方可以铸造代币 / 冻结代币、转账手续费 >1%、单个钱包持有量 >50% 或前 10 个钱包持有量 >80%（不含 AMM 池）、持有人少于 25 个、AMM 流动性不足 500 XRP、发行方成立未满 14 天、域名未列出该发行方	判定为警示
✅ 良好 / ℹ️ 信息	官方发行方、供应量已黑洞处理、已验证域名、流动性充足	仅作参考

受监管的稳定币可能保留发行方控制权。官方身份与控制策略判定相互独立：clawback 属于严重失败，即使发行方是官方发行方也不例外。评分（0–100）仅供粗略参考。不构成财务建议。 这些是检查时的账本事实。

构建者

Zach Riehn（Launch Lab，面向人类和 AI Agent 的 XRPL 工具）。Launch Lab 还运营按次付费的 x402 API（XRPL 上的 XRP/RLUSD、Base 上的 USDC），提供更深入的钱包和代币报告。Token Guard 是免费的开源核心。

采用 MIT 许可证。

发行方控制策略（2026-10-18）

满足以下任一条件时，冻结控制检查通过：已设置 NoFreeze；或主密钥已禁用、RegularKey 恰为 rrrrrrrrrrrrrrrrrrrrBZbvji，且不存在签名者列表。所有发行方的 clawback 权限均属严重失败，包括受监管的稳定币；已启用 Global Freeze 也属于失败。MCP 结构化输出会报告 freeze_control_pass、issuer_controls_pass 和确切规则。缺少 regular key 不能作为所要求的黑洞证明。仅设置 NoFreeze 无法阻止铸造代币或启用 Global Freeze。身份、集中度和其他检查仍然适用。评分是机械计算得出的，并非安全概率。