内容
<p align="center">
<a href="https://three.ws"><img src="https://three.ws/three-ws-mcp-icon.svg" alt="three.ws" width="88" height="88"></a>
</p>
<h1 align="center">@three-ws/vanity-mcp</h1>
<p align="center"><strong>从任意AI代理读取three.ws的虚荣地址奖励市场和稀有度画廊。</strong></p>
<p align="center">
<a href="https://www.npmjs.com/package/@three-ws/vanity-mcp"><img alt="npm" src="https://img.shields.io/npm/v/@three-ws/vanity-mcp?logo=npm&color=cb3837"></a>
<img alt="license" src="https://img.shields.io/npm/l/@three-ws/vanity-mcp?color=3b82f6">
<img alt="node" src="https://img.shields.io/node/v/@three-ws/vanity-mcp?color=339933&logo=node.js">
<a href="https://registry.modelcontextprotocol.io/?q=io.github.nirholas"><img alt="MCP Registry" src="https://img.shields.io/badge/MCP%20Registry-io.github.nirholas-0ea5e9"></a>
<a href="https://three.ws"><img alt="three.ws" src="https://img.shields.io/badge/built%20by-three.ws-000"></a>
</p>
---
> 一个 [模型上下文协议](https://modelcontextprotocol.io) 服务器，允许任何AI助手通过stdio读取three.ws的 **虚荣地址奖励市场** 的读取/发现表面。 引用Solana虚荣模式的难度以及要托管的金额，评估任何地址的稀有度，浏览实时奖励板， 可领取队列，统计数据，排行榜，配置和挖矿证明画廊。
市场是秘密盲的：请求者为一个模式托管一个USDC奖励，一组独立的工作者并行挖掘它，第一个提交与模式匹配的已验证密钥的工作者将获得奖励 - 但找到的密钥对请求者保密，因此工作者无需查看钱包即可获得奖励。 **发布奖励和领取奖励是HTTP API上的x402付费写入路径**；此MCP公开读取/发现 + 稀有度表面。 无需API密钥，无需签名者，无需付款 - 每个调用都会命中公共`/api/vanity`端点。
## 安装
```bash
npm install @three-ws/vanity-mcp
```
或使用`npx`运行（无需安装）：
```bash
npx @three-ws/vanity-mcp
```
## 快速开始
**Claude 代码**，一行：
```bash
claude mcp add vanity -- npx -y @three-ws/vanity-mcp
```
**Claude Desktop / Cursor** (`claude_desktop_config.json` 或 `mcp.json`）：
```json
{
"mcpServers": {
"vanity": {
"command": "npx",
"args": ["-y", "@three-ws/vanity-mcp"]
}
}
}
```
使用MCP检查器检查表面：
```bash
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）。
## 示例
```jsonc
// vanity_quote
> { "prefix": "THREE" }
{
"ok": true,
"pattern": { "prefix": "THREE", "suffix": null, "ignoreCase": false },
"difficulty": { "expectedAttempts": 656356768, "tier": "epic", "tierLabel": "Epic" },
"oracle": { "suggestedAtomics": "500000", "suggestedUsdc": "0.50" },
"band": { "floorAtomics": 50000, "maxAtomics": 50000000, "decimals": 6, "asset": "USDC" }
}
```
## 要求
- **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](./LICENSE)
---
<p align="center">
<sub>
three.ws SDK套件的一部分 — 3D AI代理，链上身份和代理付款。<br/>
<a href="https://three.ws">网站</a> · <a href="https://three.ws/changelog">更新日志</a> · <a href="https://github.com/nirholas/three.ws">GitHub</a>
</sub>
</p>
## 许可证
Copyright © 2026 nirholas. 版权所有。
本软件是专有软件 - 见 [LICENSE](./LICENSE)。 未经版权所有者明确书面许可，不得授予任何权利。
