$THREE Token

@three-ws/three-token-mcp

首个操作会销毁代币的 MCP 服务——让任何 AI Agent 都能在 Solana 上查询价格、持有并销毁 $THREE。

安装 · 快速开始 · 工具 · 要求 · three.ws

---

一个 模型上下文协议 服务，通过 stdio 为任何 AI 助手提供三种 $THREE 基础功能：读取实时 USD 价格、读取钱包余额，以及在链上销毁 $THREE——通过 Jupiter 实时定价，并在销毁地址与 three.ws 金库之间分配。将通缩作为 Agent 的基础能力：每次 three_burn 调用都会产生一笔真实、可验证的 Solana 交易，永久减少 $THREE 供应量，并为金库提供资金。

$THREE 是此服务唯一操作的代币。合约地址（主网 SPL）：FeMbDoX7R1Psc4GEcvJdsbNbZA3bfztcyDCatJVJpump。

有何不同

大多数付费 MCP 服务使用 USDC 结算。此服务转移的是项目自己的代币，而且目标地址并未硬编码——它们会在运行时从 three.ws 的公开代币接口（/api/token/config、/api/token/price）读取，因此铸币地址、小数位数、销毁地址、金库以及分配比例始终与 three.ws 其余服务使用的规范链上配置一致。签名前，系统会断言解析出的铸币地址与上述规范 $THREE 地址相同——错误配置或遭入侵的端点无法将销毁操作重定向到其他代币。

安装

npm install @three-ws/three-token-mcp

通过 npx 直接运行（无需安装）：

SOLANA_SECRET_KEY=<base58> npx @three-ws/three-token-mcp

也可以全局安装，以便在 PATH 中使用 three-token-mcp 可执行程序：

npm install -g @three-ws/three-token-mcp

快速开始

Claude Code，一行即可：

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

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

{
	"mcpServers": {
		"three-token": {
			"command": "npx",
			"args": ["-y", "@three-ws/three-token-mcp"],
			"env": {
				"SOLANA_SECRET_KEY": "<base58 secret of the wallet that holds $THREE>",
				"SOLANA_RPC_URL": "https://your-rpc-provider"
			}
		}
	}
}

只有使用 three_burn 时才需要 SOLANA_SECRET_KEY。只读工具（three_price、three_balance）无需此变量。使用 MCP Inspector 查看可用功能：

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

工具

工具	类型	功能
three_price	只读	获取 $THREE 的实时美元价格（优先使用 Jupiter，备用 Birdeye）。传入 usd 还可获取代币数量报价。
three_balance	只读	查询任意公钥的 $THREE + SOL 余额（默认为已配置的签名者）。
three_burn	执行	在一笔 Solana 交易中销毁指定美元金额的 $THREE，并拆分至焚化地址和财库。返回签名、明细和 Solscan 链接。

three_burn 会销毁钱包已经持有的 $THREE。若要先获取 $THREE，请在任意 Solana DEX 上将 SOL 兑换为 $THREE，然后再销毁。

安全性

这三个工具都提供 MCP 工具注解：three_price 和 three_balance 声明了 readOnlyHint: true，可以安全地自动批准；three_burn 则标记为 destructiveHint: true，因此支持注解的 MCP 客户端（Claude Code、Claude Desktop、Cursor）会在执行前请求确认。这些提示仅供参考——在服务端，每次销毁仍受 MAX_BURN_USD 限制（默认 $100），受 REQUIRE_CONFIRM 控制（默认开启：必须再次传入 confirm: true，否则调用会被拒绝），并且签名前会验证解析出的铸币地址是否为规范的 $THREE 地址；这些措施均独立于客户端。

输入参数

three_price — usd（可选正数：要换算为 $THREE 的美元金额）。

three_balance — pubkey（可选 base58 字符串，长度为 32–64 个字符；默认为已配置签名者的地址）。

three_burn — usd（必填正数：要销毁的 $THREE 的美元价值）、burnBps（0–10000，默认 5000 = 销毁 50% / 财库 50%；10000 = 全部销毁）、memo（可选，≤120 个字符；附加到链上备注）、secret（可选 base58 签名者覆盖值；默认为 SOLANA_SECRET_KEY）、confirm（当 REQUIRE_CONFIRM 开启时，必须为 true 才会执行不可逆销毁）。

示例

// three_price
> { "usd": 5 }
{ "price_usd": 0.0042, "quote": { "usd": 5, "token_amount": 1190.47, "atomics": "1190476190" } }

// three_burn — irreversible; confirm:true required by default
> { "usd": 5, "burnBps": 5000, "confirm": true }
{
  "ok": true,
  "signature": "5x...",
  "explorer": "https://solscan.io/tx/5x...",
  "usd": 5,
  "burned": 595.23,
  "legs": [
    { "role": "burn", "amount": 595.23 },
    { "role": "treasury", "amount": 595.23 }
  ]
}

销毁交易的构建方式

three_burn 采用经过验证的 three.ws 浏览器支付流程：

1. GET /api/token/config → 铸币地址、小数位数、焚化地址、财库。
2. GET /api/token/price?usd=<n> → Jupiter 实时价格和精确的 $THREE 最小单位数量。
3. 构建一笔交易：每个分配部分（销毁 + 财库）各包含一个幂等 ATA 创建指令和一个 SPL 转账指令，另附一条在链上标记此次销毁的备注。若金额无法按 burnBps 整除，剩余的最小单位会分配给销毁部分，确保销毁部分不会少于其应得份额；使用 burnBps: 10000（或配置中没有财库）时，交易只有一个分配部分，所有代币都会被销毁。
4. 使用你的钱包签名、发送并确认。结果会报告链上签名和各部分的金额。

服务端会预先检查你的 $THREE 余额；如果余额不足以支付销毁金额，会立即返回清晰的错误，不会产生不透明的链上失败。销毁金额受 MAX_BURN_USD 限制（默认 $100），并受 REQUIRE_CONFIRM 控制（默认开启）。

要求

• Node.js >= 20。
• Solana 主网 RPC 端点（公共集群可用于只读操作；销毁操作请自行准备端点，例如 Helius / Quicknode / Triton）。端点必须使用 https（仅本地开发验证器接受 http://localhost）。
• 销毁操作需要：持有 $THREE 的钱包，并通过 base58 格式的 SOLANA_SECRET_KEY 提供（或在单次调用中传入 secret）。

环境变量

变量	必填	默认值
SOLANA_SECRET_KEY	仅销毁时必填	无（接受 FUNDER_SECRET 作为备用值）
SOLANA_RPC_URL	否	https://api.mainnet-beta.solana.com
THREE_WS_BASE	否	https://three.ws
MAX_BURN_USD	否	100
REQUIRE_CONFIRM	否	true（设置为 0/false 可跳过确认步骤）
THREE_BURN_ADDRESS	否	Solana 焚烧地址

链接

• 主页：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}