three.ws Naming

本地服务

three.ws金融数据255今天更新

关于 three.ws Naming

three.ws Naming 是一个只读 MCP 服务，用于解析 Solana .sol 域名、反向查询钱包的主域名，并检查 *.threews.sol 智能体标识是否可用。适合需要为 AI Agent 提供链上身份的场景，无需 API Key 即可调用。

主要功能

01将 .sol 域名解析为钱包地址
02通过钱包地址反向查询主域名
03检查 threews.sol 子域名是否可用
04调用 Solana 主网公开数据，无需密钥

适用场景

01在 AI 助手中解析某个 .sol 域名的所有者
02检查某个 Agent 名称是否仍可认领
03根据钱包地址查找其对应的 .sol 名称

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "nirholas-naming": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/naming-mcp"
      ],
      "env": {
        "THREE_WS_BASE": "<THREE_WS_BASE>",
        "THREE_WS_TIMEOUT_MS": "<THREE_WS_TIMEOUT_MS>"
      }
    }
  }
}

启动命令npx -y @three-ws/naming-mcp

需要配置的环境变量

THREE_WS_BASEBase URL of the three.ws API that serves /api/sns and /api/threews/subdomain. Override only when self-hosting or targeting a preview deployment.

THREE_WS_TIMEOUT_MSPer-request timeout in milliseconds. Resolution and availability checks hit a Solana RPC pool, so the default leaves room for a cold lookup.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@three-ws/naming-mcp0.1.3stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

@three-ws/naming-mcp

AI Agent 的链上身份层 — 解析 .sol 名称，并在 three.ws 上为你的 Agent 认领一个名称。

许可证

一个通过 stdio 为任何 AI 助手提供 three.ws 命名 / 身份层的 Model Context Protocol 服务。将 Solana .sol 名称解析为其所有者的钱包地址，将钱包反向查询为其主要名称，并检查 *.threews.sol Agent 句柄是否仍可认领。

这是 three.ws 的身份层：头像赋予你的 Agent 一张面孔，场景赋予它一个世界，名称则赋予它一个身份。*.threews.sol 子域名可在 https://three.ws/u/<label> 展示 Agent 个人资料 — 认领一个子域名，就能为你的 Agent 取一个名称。无需 API 密钥、签名者或付款 — 每次调用都会访问公开的 /api/sns 和 /api/threews/subdomain 端点，并由 Solana / Bonfida SNS（主网）提供支持。

注意： 铸造 *.threews.sol 子域名需要通过 three.ws HTTP API 的已认证写入路径。此 MCP 服务提供公开的解析 + 可用性读取；找到可用句柄后，请通过你的 three.ws 账户认领。

安装

npm install @three-ws/naming-mcp

或使用 npx 运行（无需安装）：

npx @three-ws/naming-mcp

快速开始

Claude Code，一行命令：

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

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

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

使用 MCP Inspector 检查工具界面：

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

工具

工具	类型	功能
`sns_resolve`	只读	将 `.sol` 名称解析为其所有者的 base58 钱包地址。
`sns_reverse`	只读	反向查询钱包，获取其主要 `.sol` 名称。
`threews_availability`	只读	检查 `<label>.threews.sol` 是否可作为 three.ws Agent 身份认领。

这三个工具都会实时读取 Solana 主网的公开数据。没有所有者的 .sol 名称（或没有收藏名称的钱包）会返回 resolved: false — 这是常见且预期的结果，并非错误。

输入参数

sns_resolve — name（必填：.sol 标签、子域名或完整名称，可带或不带末尾的 .sol）。

sns_reverse — address（必填：base58 格式的 Solana 公钥）。

threews_availability — label（必填：要检查的句柄，例如 nick.threews.sol 中的 nick；长度为 1–63 个字符，字符范围为 [a-z0-9-]）。

示例

// sns_resolve
> { "name": "bonfida" }
{
  "ok": true,
  "name": "bonfida.sol",
  "address": "Fw1ETanDZafof7xEULsnq9UY6o71Tpds89tNwPkWLb1v",
  "resolved": true
}

// threews_availability
> { "label": "test" }
{
  "ok": true,
  "full": "test.threews.sol",
  "label": "test",
  "available": true,
  "owner": null,
  "on_chain_check": "ok",
  "showcase_url": null
}