three.ws Naming

@three-ws/naming-mcp

AI エージェントのオンチェーンアイデンティティレイヤー — .sol 名を解決し、three.ws でエージェントの名前を取得できます。

---

stdio 経由で、あらゆる AI アシスタントに three.ws のネーミング／アイデンティティレイヤーを提供するModel Context Protocol サーバーです。Solana の .sol 名から所有するウォレットを解決し、ウォレットからプライマリ名を逆引きし、*.threews.sol エージェントハンドルがまだ取得可能かどうかを確認できます。

これは three.ws のアイデンティティレイヤーです。アバターがエージェントに顔を与え、シーンが世界を与えるように、名前はアイデンティティを与えます。*.threews.sol サブドメインは https://three.ws/u/<label> にエージェントプロフィールを表示します。取得すると、エージェントに名前を付けられます。API キーも署名者も支払いも不要です。すべての呼び出しは、Solana／Bonfida SNS（メインネット）を基盤とする公開 /api/sns および /api/threews/subdomain エンドポイントにアクセスします。

注： *.threews.sol サブドメインのミントは、three.ws HTTP API における認証が必要な書き込みパスです。この MCP サーバーが公開するのは、解決と取得可否の読み取りです。取得可能なハンドルが見つかったら、three.ws アカウントから取得してください。

インストール

npm install @three-ws/naming-mcp

または npx で実行します（インストール不要）：

npx @three-ws/naming-mcp

クイックスタート

Claude Code の場合、1 行で設定できます：

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 のエージェントアイデンティティとして取得可能か確認します。

3 つのツールはいずれも、Solana メインネットに対する公開データの読み取りをリアルタイムで行います。所有者のいない .sol 名（またはお気に入りの名前がないウォレット）に対しては resolved: false が返されます。これは通常想定される応答であり、エラーではありません。

入力パラメーター

sns_resolve — name（必須：.sol のラベル、サブドメイン、または末尾の .sol の有無を問わない完全な名前）。

sns_reverse — address（必須：base58 形式の Solana 公開鍵）。

threews_availability — label（必須：確認するハンドル。例：nick.threews.sol の場合は nick。[a-z0-9-] の 1～63 文字）。

使用例

// 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
}

要件

• 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 エージェント、オンチェーン ID、エージェント向け決済。
ウェブサイト · 変更履歴 · GitHub}