XRPName

Name: XRPName
Author: XRPDomains

远程服务

xrpdomains.xyz金融数据12 周前更新

代码仓库访问官网

关于 XRPName

XRPName 将 XRPL 上的 XRPDomains 名称功能提供给 AI Agent 和 MCP 客户端。它支持只读查询与持仓检查，注册和设置主名称则通过链接交由用户签名完成。

主要功能

01查询可用性、价格和所有者
02按关键词推荐名称
03读取名称资料与历史
04查看地址持仓和报价
05查询交易与订单状态
06提供注册和设置主名称链接

适用场景

01注册前检查名称
02查看 XRPL 地址持有的名称
03查阅名称资料和记录
04打开链接注册或设置主名称

MCP 相关

该 MCP 服务向 MCP 客户端提供 XRPDomains 查询、资料、持仓和状态工具。写入操作会返回 xrpdomains.xyz 链接；服务不会构建或持有交易。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://xrpdomains.xyz/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http xrpdomains-xrpname https://xrpdomains.xyz/mcp

Cursor.cursor/mcp.json{"mcpServers":{"xrpdomains-xrpname":{"type":"http","url":"https://xrpdomains.xyz/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"xrpdomains-xrpname":{"type":"http","url":"https://xrpdomains.xyz/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"xrpdomains-xrpname":{"type":"http","url":"https://xrpdomains.xyz/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"xrpdomains-xrpname":{"serverUrl":"https://xrpdomains.xyz/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

安装包

npm@xrpname/xrpname-mcp0.1.1stdio

工具

参数	类型	必填	说明
domains	array	是	要检查的域名列表。每个域名可以包含或省略 TLD；默认使用 .xrp。

详细介绍

XRPName MCP 服务

面向 AI Agent 的 XRPL 域名。XRPName 通过模型上下文协议提供 XRPDomains 命名系统——.xrp、.xrpl、.xrpfi、.rlusd，让 Claude、Cursor 和 Codex 等助手可以检查可用性、查询价格和资料、读取钱包的域名组合，并向用户提供注册链接。

按设计仅支持只读操作和网页链接。 服务仅读取公开的 XRPL 和注册表数据；写入操作（注册、设置主域名）会返回 xrpdomains.xyz 链接，用户可以打开该链接并使用自己的钱包签名。本服务无需 API 密钥或私钥，也不会构建或持有任何交易。

工具

工具	类型	功能
`check_domains`	只读	一次检查最多 25 个域名的可用性、价格和所有者
`recommend_domain`	只读	根据关键词提供 AI 名称建议，并附上可用性和价格
`get_domain_profile`	只读	获取已注册域名的完整资料（所有者、记录、历史）
`get_portfolio`	只读	获取 XRPL 地址持有的所有域名
`resolve_address`	只读	反向查询：地址 → 主 XRPName + 所有已拥有的名称
`get_pending_offers`	只读	获取地址的待处理买卖报价和铸造记录
`check_tx_status`	只读	按哈希查询 XRPL 交易状态
`check_order_status`	只读	按域名查询注册订单状态
`register_domain`	链接	返回 `xrpdomains.xyz` 链接，用于注册可用域名
`set_primary_domain`	链接	返回链接，用于将域名设为地址的主域名

安装

托管版（推荐——无需安装）

服务运行在远程地址 https://xrpdomains.xyz/mcp（Streamable HTTP，无需身份验证）。

# Claude Code
claude mcp add xrpname-mcp --transport http https://xrpdomains.xyz/mcp

Claude Desktop / Cursor——添加到 MCP 配置中：

{
  "mcpServers": {
    "xrpname-mcp": { "url": "https://xrpdomains.xyz/mcp", "transport": "http" }
  }
}

本地版（此 npm 包——stdio）

在本地运行相同的工具，并连接到公开的 XRPDomains API。无需凭据。

npx -y @xrpname/xrpname-mcp

将其接入任意 MCP 客户端的 stdio 配置：

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

每个 GitHub Release 均附带一键安装的 Claude Desktop 扩展（.mcpb）。

配置

所有设置均为可选项——默认连接公开的主网 API。

变量	默认值	用途
`XRPDOMAINS_API_BASE`	`https://xrpdomains.xyz`	后端 REST API 基础地址
`XRPL_WSS_URL`	`wss://xrplcluster.com`	用于查询交易状态的 XRPL 节点
`REDIS_URL`	(内存中)	可选的缓存/速率限制后端
`PORT`	`3000`	HTTP 端口（仅远程传输）
`LOG_LEVEL`	`info`	Pino 日志级别

完整列表（包括速率限制和分析设置）请参阅 .env.example。

链接

设置与所有工具： https://xrpdomains.xyz/agent
MCP Registry： io.github.XRPDomains/xrpname-mcp-server
代码仓库： https://github.com/XRPDomains/xrpname-mcp-server
问题反馈： https://github.com/XRPDomains/xrpname-mcp-server/issues

开发

npm ci
npm run build        # tsc → dist/
npm test             # vitest
npm run typecheck    # tsc --noEmit
npm run dev          # remote HTTP server (watch)
npm run dev:stdio    # local stdio server (watch)