three.ws Vanity

@three-ws/vanity-mcp

让任何 AI Agent 都能读取 three.ws 靓号地址悬赏挖掘市场和稀有度图库。

---

一个 Model Context Protocol 服务，通过 stdio 为任何 AI 助手提供 three.ws 靓号地址悬赏挖掘市场的读取和发现功能。可估算 Solana 靓号模式的挖掘难度及其托管金额，评估任意地址的稀有度，并浏览实时悬赏看板、可认领队列、统计数据、排行榜、配置和挖掘证明图库。

该市场不会泄露秘密：悬赏发布者为某个模式托管 USDC 悬赏金，由一支独立工作者组成的集群并行挖掘；首位提交与模式匹配且通过验证的密钥将获得链上付款——但找到的秘密会加密封存，仅向悬赏发布者开放，因此工作者无需看到钱包即可赚取悬赏金。发布悬赏和认领悬赏是 HTTP API 上通过 x402 付费的写入路径；此 MCP 提供读取、发现和稀有度功能。无需 API 密钥、签名者或付款——每次调用都会访问公开的 /api/vanity 端点。

安装

npm install @three-ws/vanity-mcp

也可以使用 npx 运行（无需安装）：

npx @three-ws/vanity-mcp

快速开始

Claude Code，一行命令：

claude mcp add vanity -- npx -y @three-ws/vanity-mcp

Claude Desktop / Cursor（claude_desktop_config.json 或 mcp.json）：

{
	"mcpServers": {
		"vanity": {
			"command": "npx",
			"args": ["-y", "@three-ws/vanity-mcp"]
		}
	}
}

使用 MCP Inspector 检查功能：

npx -y @modelcontextprotocol/inspector npx @three-ws/vanity-mcp

工具

工具	类型	功能
vanity_quote	只读	为模式定价：预期尝试次数、稀有度等级和合理建议的 USDC 悬赏金额。具有幂等性。
vanity_appraise	只读	评估任意 Solana 地址的稀有度（模式、分数、位数、等级、尝试次数）。具有幂等性。
vanity_board	只读	浏览挖掘悬赏看板——按状态筛选，按最近时间、奖励或到期时间排序，并分页。
vanity_open	只读	列出工作者轮询的可认领开放悬赏队列。
vanity_stats	只读	市场实时总览：开放数量、托管的 USDC、已支付的 USDC。
vanity_leaderboard	只读	按累计赚取的 USDC 排名的顶尖挖掘者。
vanity_config	只读	付款可用性及资产／网络元数据（结算资产、小数位数、网络、定价范围）。
vanity_gallery	只读	浏览挖掘证明稀有度图库——可排序、按等级／长度／子字符串筛选并分页。

vanity_quote 和 vanity_appraise 是输入的纯函数（相同模式／地址 → 相同结果），因此标记为幂等。其他六个工具读取实时市场和图库。

输入参数

vanity_quote — prefix（可选的 Base58 前缀）、suffix（可选的 Base58 后缀）、ignoreCase（布尔值，默认 false）。必须提供 prefix 或 suffix 中的至少一个。

vanity_appraise — address（必填，Base58 地址，32–44 个字符）、prefixLen（整数，可选）、suffixLen（整数，可选）。

vanity_board — status（open | all | settled，默认 open）、sort（recency | reward | expiry，默认 recency）、limit（1–100，默认 24）、offset（默认 0）。

vanity_open — limit（1–100，默认 30）。

vanity_stats — 无参数。

vanity_leaderboard — limit（1–100，默认 10）。

vanity_config — 无参数。

vanity_gallery — sort（score | recency，默认 score）、tier（字符串）、minLength（整数）、contains（字符串）、limit（1–100，默认 24）、offset（默认 0）。

示例

// vanity_quote
> { "prefix": "THREE" }
{
  "ok": true,
  "pattern": { "prefix": "THREE", "suffix": null, "ignoreCase": false },
  "difficulty": {
    "expectedAttempts": 11308763834,
    "rarityBits": 39,
    "tier": "mythic",
    "tierLabel": "Mythic",
    "accent": "#ff5db1",
    "expectedGrindSeconds": 7539
  },
  "oracle": {
    "floorAtomics": 50000,
    "suggestedAtomics": 2094216,
    "generousAtomics": 5235540,
    "maxAtomics": 5000000000,
    "expectedAttempts": 11308763834,
    "expectedGrindSeconds": 7539,
    "model": "58^effectiveLength @ refRate"
  },
  "band": { "floorAtomics": 50000, "maxAtomics": 5000000000, "decimals": 6, "asset": "USDC" }
}

示例

可运行的示例位于 examples/：

node examples/list-tools.mjs           # every tool with its full input schema
node examples/quote-and-appraise.mjs   # config + quote + appraise + stats, live

两者都会通过 stdio 启动此服务，并读取实时市场。这里的所有工具均为只读，因此无法发布、认领或付款。预期输出请参阅 examples/README.md。

要求

• Node.js >= 20。
• 可访问网络 https://three.ws（或使用你自己的 THREE_WS_BASE）。

环境变量

变量	必填	默认值
THREE_WS_BASE	否	https://three.ws
THREE_WS_TIMEOUT_MS	否	20000

链接

• 主页：https://three.ws
• 更新日志：https://three.ws/changelog
• 问题反馈：https://github.com/nirholas/three.ws/issues
• 许可证：Apache-2.0，参见 LICENSE

---

_{属于 three.ws SDK 套件的一部分 — 3D AI Agent、链上身份与 Agent 付款。
网站 · 更新日志 · GitHub}