AI导哈

区块链服务器

Radiant MCP Server是一个为Radiant区块链设计的模型上下文协议服务器，支持AI代理查询链状态、管理Glyph代币、解析WAVE名称以及构建、签名和广播交易。

  • by Radiant-Core
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Radiant-Core/radiant-mcp-server

使用说明

Radiant MCP服务器

Radiant区块链的模型上下文协议（MCP）服务器 --允许AI代理查询链状态、管理Glyph令牌、解析WAVE名称，并在给定私钥时在Radiant网络上构建、签名和广播事务。

⚠️ 此服务器可以持有私钥并转移资金

与只读数据服务器不同，辐射式mcp服务器公开了一个完整的 书写/签名表面。它可以：

  • 在服务器端存储WIF私钥 在钥匙圈中 ~/.radiant-mcp/keyring.json （用覆盖 RADIANT_KEYRING_FILE).该文件必须是 0600 （仅限所有者读/写）在POSIX上——否则服务器将拒绝加载它。
  • 生成和恢复钱包 --随机密钥和BIP39助记符——在工具输出中返回WIF私钥和种子短语。
  • 构建、签署和广播交易 --发送RXD、批量支付和mint/transfer/burn Glyph令牌——使用每次调用传递的瞬态WIF或密钥环别名引用的密钥。

连接到此服务器的任何代理或客户端都可以调用这些工具。 把连接它当作交一个热钱包。 阅读 安全和密钥处理 在将其暴露在环回之外之前。

特征

12个类别的59个工具

读取/查询工具不需要密钥。这 钥匙环, 钱包，以及 交易 类别持有或接收私钥，可以转移资金——请参阅 安全和密钥处理.

读取和查询--没有私钥

区块链（8个工具）

  • radiant_get_chain_info --当前链状态（高度、尖端哈希、网络参数）
  • radiant_get_balance --地址的RXD余额（已确认+未确认）
  • radiant_get_utxos --列出地址的未使用输出
  • radiant_get_history --地址的完整交易历史记录（返回所有条目——对于活动地址来说很大）
  • radiant_get_transaction --按txid列出的交易详细信息
  • radiant_get_block_header --按高度划分的块标题
  • radiant_estimate_fee --费用估算（ElectrumX估算+最小中继政策下限）
  • radiant_broadcast_transaction --广播a 预先签名 原始tx（不需要密钥，但会发布到网络）

Glyph代币（10个工具）

  • radiant_get_token --参考令牌信息
  • radiant_list_tokens --地址持有的代币
  • radiant_get_token_balance --地址的特定令牌余额
  • radiant_search_tokens --按名称/股票代码搜索代币
  • radiant_get_token_metadata --完整的CBOR元数据
  • radiant_get_token_history --代币交易历史
  • radiant_get_tokens_by_type --按类型过滤令牌（FT/NTF/等）
  • radiant_validate_protocols --检查Glyph协议组合是否有效
  • radiant_parse_glyph_envelope --从原始脚本十六进制解码Glyph信封
  • radiant_get_token_utxos --发现所有代币UTXO（及其 tokenRefs） 由地址持有

dMint挖掘（4个工具）

  • radiant_get_dmint_contracts --列出当前可开采的代币
  • radiant_get_dmint_contract --一个dMint合约的详细信息
  • radiant_get_dmint_by_algorithm --通过挖掘算法过滤的dMint合约
  • radiant_get_most_profitable_dmint --dMint合约按盈利能力排名

WAVE命名（5个工具）

  • radiant_resolve_wave_name --将WAVE名称解析为其区域记录
  • radiant_check_wave_available --检查名称可用性
  • radiant_wave_reverse_lookup --地址所拥有的姓名
  • radiant_wave_subdomains --列出WAVE名称的子名称
  • radiant_wave_stats --命名系统统计

DEX/Swap（2个工具）

  • radiant_get_swap_orders --一对未结掉期订单（链上订单）
  • radiant_get_swap_history --代币的交易历史

连接和监控（3个工具）

  • radiant_connection_health --ElectrumX连接状态和延迟
  • radiant_reconnect --会话被卡住时，强制重新连接新的ElectrumX
  • radiant_watch_address --订阅地址的实时付款通知（ElectrumX scripthash订阅）

实用程序/参考（2个工具）

  • radiant_get_protocol_info --Glyph协议类型参考
  • radiant_validate_address --验证地址；显示其类型（P2PKH/P2SH）和脚本哈希

脚本工具--脱机（2个工具）

  • radiant_decode_script --将原始脚本十六进制解码为人类可读的操作码（无网络）
  • radiant_compile_script --编译RadiantScript(.cash/.rxd)将源代码转换为部署工件（ABI、ASM、十六进制）。线下；需要 rxdc 编译器二进制（set RXDC_PATH，或将RadiantScript仓库保留为兄弟目录）

链上AI原语（9个工具）

  • radiant_create_inference_proof --blake3推理证明承诺 hash(modelHash ‖ inputHash ‖ output)
  • radiant_verify_inference_proof --验证链下的推理证明承诺
  • radiant_build_agent_profile --构建一个具有blake3承诺的AI代理身份配置文件（+WAVE区域记录）
  • radiant_resolve_agent_identity -从WAVE名称解析代理的身份（功能、定价、API端点）
  • radiant_check_token_access --令牌门控访问检查（地址是否持有最低余额？）
  • radiant_open_channel --建立小额支付渠道的初始状态
  • radiant_update_channel --更新通道状态（转移光子付款人→ 收款人）
  • radiant_build_data_asset --为数据市场资产构建Glyph NFT元数据
  • radiant_search_data_assets --搜索数据市场（数据集、模型等）

这些AI原语计算承诺/元数据或读取链状态——它们确实如此 不 按住按键或广播。使用下面的交易工具在链上发布他们的输出。

写入和签名——涉及私钥

🔑 接下来的三类是与安全相关的表面。看 安全和密钥处理.

Keyring——服务器端WIF存储（3个工具）

  • radiant_register_key --在服务器端密钥环中的别名下存储WIF私钥(~/.radiant-mcp/keyring.json, 0600).让签名工具通过以下方式引用密钥 key_alias 而不是在每次通话时重新发送WIF
  • radiant_list_keys --列出已注册的别名及其派生地址（WIF是 从不 返回）
  • radiant_remove_key --从密钥环中删除别名

钱包——密钥生成和衍生（3个工具）

  • radiant_create_wallet --生成一个新钱包（随机密钥，或BIP39助记符，带有BIP32 HD派生）。 返回WIF，如果需要，返回助记符
  • radiant_restore_wallet --使用BIP39助记词还原钱包。 返回导出的WIF
  • radiant_derive_address --从助记符+BIP32路径导出地址/公钥/WIF（每个任务子钱包）

交易——构建、签名和广播（8个工具）

每个都接受一个瞬态 wif （通过运输工具发送） 或 一 key_alias 除非特别注明，否则这些标志 和广播.

  • radiant_send_rxd --发送RXD：选择硬币、构建、签名、广播🔑
  • radiant_send_batch --在一次交易中向最多100个收件人发送RXD🔑
  • radiant_transfer_token --将Glyph FT/NFT转移到另一个地址🔑
  • radiant_burn_token --永久销毁Glyph代币（Glyph协议6）🔑
  • radiant_create_ft --铸造一个Glyph可变形代币（2次提交+公开）🔑
  • radiant_create_nft --制作一个Glyph NFT（2次提交+展示）🔑
  • radiant_build_transaction --构建 并签字 模拟运行模式下的交易；返回原始十六进制/费用/大小 没有 广播（套 dry_run=false 广播）。在提交高价值交易之前进行检查🔑
  • radiant_estimate_tx_fee --根据输入/输出计数估算费用（纯算术-- 没有密钥，没有网络，没有广播)

10资源

静态参考数据（6）

  • radiant://docs/chain-overview --区块链概述
  • radiant://docs/opcodes --操作码参考（包括V2）
  • radiant://docs/protocols --字形协议、dMint算法、DAA模式
  • radiant://docs/network-params --网络参数（JSON）
  • radiant://docs/sdk-quickstart --弧度快速入门指南
  • radiant://docs/knowledge-base --全面的人工智能知识库

动态/实时数据（4）

  • radiant://chain/status --实时链状态（高度、尖端哈希、同步状态）
  • radiant://dmint/active --当前活跃的dMint合约
  • radiant://network/fees --几个确认目标的费用估算
  • radiant://tokens/popular --流行的可替代代币和NFT集合

运输

相同的59个工具和10个资源在三次传输中暴露出来（所有这些都是由单一的事实来源驱动的） src/register-tools.ts):

传输 输入 开始 默认绑定
标准 （MCP） dist/index.js npm start / npm run dev 本地进程（由Windsurf、Claude Desktop、Cursor使用）
表征状态转移 （HTTP） dist/rest.js npm run start:rest 127.0.0.1:3080
上海证券交易所 （基于HTTP的MCP） dist/sse.js npm run start:sse 127.0.0.1:3090

REST API

标准的REST API为任何HTTP客户端镜像工具。关键处理端点(/keyring/*, /wallet/*, /tx/*, /token/*)是身份验证门控的--请参阅 安全和密钥处理.

# Start REST server
npm run start:rest

# Query chain info
curl http://localhost:3080/api/chain

# Get address balance
curl http://localhost:3080/api/address/1A1zP1.../balance

# Search tokens
curl http://localhost:3080/api/tokens/search?q=mytoken

# Full endpoint list
curl http://localhost:3080/api

OpenAPI 3.1规范： docs/openapi.yaml

安全和密钥处理

此服务器具有真正的写入表面。默认设置是仅环回和保守的，但在公开服务器之前，您应该了解它们。

私钥如何到达服务器

  1. 瞬态WIF --通行证 wif 每次签约电话。它通过MCP/HTTP传输，并可能出现在代理记录和客户端日志中。
  2. 服务器端密钥环 --呼叫 radiant_register_key 一次，然后通过以下方式引用密钥 key_alias 在后续的通话中。WIF不参与后续的运输/记录，但 保存在磁盘上 在密钥环文件中。

钥匙圈文件

  • 地点： ~/.radiant-mcp/keyring.json （用覆盖 RADIANT_KEYRING_FILE).
  • 权限：必须是 0600 （仅限所有者读/写）在POSIX上。服务器 拒绝装载 权限较宽松的钥匙圈(chmod 600 <path> 修复），并将新条目写回 0600.
  • 内容：明文JSON格式的WIF私钥。任何能够阅读此文件的人都可以控制资金。 radiant_list_keys 从不返回WIF，但文件本身确实包含它们。

网络暴露和认证（REST和SSE）

两种HTTP传输 默认为环回 (HOST=127.0.0.1)因此密钥处理工具不会意外暴露在局域网中。

  • 表征状态转移 --密钥处理端点(/keyring/*, /wallet/create, /wallet/restore, /wallet/derive, /tx/send, /tx/build, /tx/send-batch, /token/create/ft, /token/create/nft, /token/transfer, /token/burn)被包裹在身份验证检查中：
    • RADIANT_API_TOKEN 集 → 这些端点需要 Authorization: Bearer <token>.
    • RADIANT_API_TOKEN 取消设置 → 这些端点是 仅限环回 (127.0.0.1 / ::1)；非环回请求获取 401.
    • 即使你设置了，这也适用 HOST=0.0.0.0 --在配置令牌之前，关键端点将保持锁定状态。 只读端点不是令牌门控的，因此绑定到 0.0.0.0 将读取查询暴露给网络。
  • 上海证券交易所 --默认情况下绑定环回，并在以下情况下记录警告 HOST 是非环回的，因为SSE传输暴露了WIF处理工具。在允许远程访问之前，先将经过身份验证的反向代理放在前面。

要远程公开写端点，请执行以下操作：set RADIANT_API_TOKEN 一个强烈的秘密，集 HOST=0.0.0.0 （理想情况下在TLS终止的反向代理后面），并在每个密钥处理请求上发送承载令牌。

安全开关

集 RADIANT_TEST_MODE （除以下值外的任何值 0/false)阻止真实广播-- radiant_broadcast_transaction 签名工具将拒绝发布。适用于干跑和CI。

安装

npm install
npm run build

配置

风浪/瀑布

添加到MCP设置(~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "radiant": {
      "command": "node",
      "args": ["/path/to/radiant-mcp-server/dist/index.js"],
      "env": {
        "ELECTRUMX_HOST": "electrumx.radiantcore.org",
        "RADIANT_NETWORK": "mainnet"
      }
    }
  }
}

⚠️ 这将启动完整的服务器，包括密钥环、钱包和签名工具。通过注册的任何密钥 radiant_register_key 写信给 ~/.radiant-mcp/keyring.json 并且可由代理在每次后续呼叫中使用。只在您信任的环境中连接它，以便对这些资金采取行动。

克劳德桌面

添加 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "radiant": {
      "command": "node",
      "args": ["/path/to/radiant-mcp-server/dist/index.js"],
      "env": {
        "ELECTRUMX_HOST": "electrumx.radiantcore.org"
      }
    }
  }
}

环境变量

变量 默认值 描述
ELECTRUMX_WSS true 通过安全的WebSocket连接(wss://host端口443）。防火墙防护，适用于移动/企业网络；需要节点22+。集 false 改用原始TCP/SSL套接字。
ELECTRUMX_HOST electrumx.radiantcore.org ElectrumX服务器主机名
ELECTRUMX_PORT 443 （wss）/ 50012 （原始） ElectrumX服务器端口
ELECTRUMX_SSL true 对原始套接字使用TLS（在以下情况下忽略 ELECTRUMX_WSS=true)
RADIANT_NETWORK mainnet 网络： mainnet 或 testnet
HOST 127.0.0.1 REST和SSE服务器的绑定地址（默认情况下为环回）
PORT 3080 REST API端口（也是SSE回退端口）
SSE_PORT 3090 SSE服务器端口
CORS_ORIGIN * CORS允许源（REST）
RADIANT_API_TOKEN （未设置） 密钥处理REST端点所需的承载令牌。未设置时，这些端点仅进行环回
RADIANT_KEYRING_FILE ~/.radiant-mcp/keyring.json 服务器端密钥环的路径（必须是 0600 在POSIX上）
RADIANT_TEST_MODE （未设置） 设置时（而不是 0/false)，阻止真实交易广播
RADIANT_RESPONSE_FORMAT both 响应中的值格式： satoshis, rxd，或 both (satoshis ~余额代币成本减半/UTXO重调用）
RXDC_PATH （自动检测） 通往 rxdc RadiantScript编译器二进制文件，由 radiant_compile_script

发展

# MCP server (development)
npm run dev

# REST API server (development)
npm run dev:rest

# SSE server (development)
npm run dev:sse

# Type check
npm run lint

# Build
npm run build

# Run tests
npx tsx test/smoke.ts   # MCP smoke test (no network)
npx tsx test/live.ts    # MCP live test (ElectrumX)
npx tsx test/rest.ts    # REST API test (ElectrumX)

建筑

AI Agent (Windsurf/Claude/Cursor)       Web App / HTTP Client
       │ MCP Protocol (stdio / SSE)            │ HTTP/REST
       ▼                                       ▼
radiant-mcp-server (index.ts / sse.ts)  radiant-rest-api (rest.ts)
  ├── Tools (59)                          ├── REST endpoints
  ├── Resources (10)                      ├── OpenAPI 3.1 spec
  │                                       └── bearer-token / loopback auth
  ├── Keyring (~/.radiant-mcp, 0600) ─────────────┤  (key-handling tools)
  └──────────┬────────────────────────────────────┘
             │ Shared ElectrumX Client (TCP/TLS)
             ▼
      RXinDexer / ElectrumX
        (Glyph + WAVE + Swap + dMint APIs)

所有传输都通过注册相同的工具/资源 src/register-tools.ts.

关于Radiant

Radiant（RXD）是一个具有原生数字资产支持的第1层UTXO工作量证明区块链。主要特点：

  • SHA512/256d 挖掘算法
  • 字形 令牌标准（FT、NFT、dMint、WAVE名称、11种协议类型）
  • 256 MB 阻碍， 5分钟 阻塞时间
  • 210亿 最大供应量
  • V2操作码 （块410000+）：OP_BLAKE3、OP_K12、OP_LSHIFT、OP_RSHIFT、OP_2MUL、OP_2DIV

许可证

麻省理工学院

相关 MCP