Kaspa Node MCP

kaspa节点mcp

MCP服务器，用于与任何 生锈的卡斯帕 通过WebSocket上的wRPC Borsh连接节点。

赋予人工智能代理（Claude Code、OpenClaw等）查询Kaspa区块链、管理钱包和提交交易的能力，包括锚定和验证链上的KPM有效载荷。

特性

• 任何网络：主网、测试网-10、测试网-11、测试网-12、开发网
• 满钱包：BIP39助记符生成、BIP44推导、加密持久性
• 交易：通过WASM生成器构建、签署和提交（符合KIP-9标准）
• KPM意识：自动解析KPM锚点有效载荷(KPM1 || mode || hash)
• 加密钱包：AES-256-GCM，带加密KDF，存储在 ~/.kaspa-mcp/wallet.enc
• 两次运输：stdio（克劳德代码）或HTTP（OpenClaw/remote）
• 延迟连接：服务器立即启动，在第一次工具调用时连接到节点

工具

只读区块链查询

钱包管理

交易

先决条件

• Node.js 20+
• 启用了wRPC Borsh的正在运行的生锈的kaspa节点

# Testnet-12
supertypo/rusty-kaspad --testnet --netsuffix=12 --utxoindex

# Mainnet
kaspad --utxoindex

安装

git clone https://github.com/27inator/Kaspa-node-mcp.git
cd kaspa-node-mcp
npm install
npm run build

用法

使用克劳德代码（stdio）

添加到您的Claude Code MCP设置中：

{
  "mcpServers": {
    "kaspa-node": {
      "command": "node",
      "args": ["/path/to/kaspa-node-mcp/dist/index.js"],
      "env": {
        "KASPA_ENDPOINT": "ws://localhost:17210"
      }
    }
  }
}

使用OpenClaw（HTTP）

KASPA_ENDPOINT=ws://localhost:17210 TRANSPORT=http PORT=3001 node dist/index.js

然后在OpenClaw中注册为MCP端点 http://localhost:3001/mcp.

钱包设置

第一次

1. Use kaspa_generate_mnemonic        → wallet auto-activates, shows address
2. Use kaspa_save_wallet(password)    → encrypted to ~/.kaspa-mcp/wallet.enc
3. Fund the address with testnet KAS

每次会议之后

Server starts → "Encrypted wallet found. Use kaspa_load_wallet to unlock."

1. Use kaspa_load_wallet(password)    → wallet unlocked, ready to use

不需要环境变量。助记符在静止时用AES-256-GCM加密（密码密钥推导，N=65536，r=8，p=1）。文件权限： 0600.

备选方案：环境变量

如果你更喜欢env变量而不是加密文件：

KASPA_MNEMONIC="your 24 word mnemonic phrase here"
# or
KASPA_PRIVATE_KEY="hex_private_key"

环境变量

按网络列出的默认端口

此服务器使用 wRPC波什 （17xxx端口），而不是JSON。

KPM锚验证

这 kaspa_verify_kpm_anchor 该工具解析KPM的链上有效载荷格式：

Bytes: "KPM1" (4 bytes) || modeByte (1 byte) || hash (32 bytes)
Total: 37 bytes

modeByte 0x01 = INDIVIDUAL (single event hash)
modeByte 0x02 = MERKLE (Merkle root)

验证流程：

1. KPM使用txid T将数据锚定在块B中
2. 呼叫 kaspa_verify_kpm_anchor blockHash=B，transactionId=T，expectedHash=X
3. 工具获取块，找到tx，解析KPM有效载荷
4. 退货 verified: true 如果链上哈希匹配

发展

npm run dev    # Watch mode (tsc --watch)
npm run build  # Compile to dist/
npm start      # Run server

测试

node test-wallet-store.mjs   # Encrypted wallet: 34 assertions
node test-full-workflow.mjs  # End-to-end: generate → save → load
node test-smoke.mjs          # Node integration (requires running TN12 node)

许可证

麻省理工学院