Kaspa MCP

🚀 Kaspa MCP

Kaspa MCP 是一個用於在 Kaspa 有向無環圖（blockDAG）上發送 KAS 代幣的服務器。它藉助先進的技術架構，為用戶提供了便捷、高效且安全的 KAS 代幣發送服務，極大地提升了用戶在 Kaspa 網絡中的操作體驗。

🚀 快速開始

Kaspa MCP 是一個用於在 Kaspa 有向無環圖（blockDAG）上發送 KAS 的 MCP 服務器。

✨ 主要特性

Kaspa 是一種快速、可擴展的第一層加密貨幣，基於工作量證明（PoW）構建，並由 GHOSTDAG 協議提供支持。GHOSTDAG 是一種新穎的共識機制，它擴展了中本聰的原始設計。與傳統區塊鏈丟棄競爭塊不同，GHOSTDAG 允許並行塊共存，並在有向無環圖（blockDAG）中對它們進行排序，從而在保持去中心化和安全性的同時實現高吞吐量。

• 每秒 10 個區塊，具有亞秒級確定性（2025 年 5 月 Crescendo 升級）
• 工作量證明，使用 kHeavyHash 算法
• 公平啟動 - 無預挖、無 ICO、無代幣分配
• 去中心化 - 在標準硬件上運行

📦 安裝指南

npm install
npm run build

📚 詳細文檔

配置

設置以下環境變量：

*必須設置 KASPA_MNEMONIC 或 KASPA_PRIVATE_KEY。

與 Claude Desktop 一起使用

添加到你的 Claude Desktop 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "kaspa": {
      "command": "npx",
      "args": ["kaspa-mcp"],
      "env": {
        "KASPA_MNEMONIC": "your twenty four word mnemonic phrase here ...",
        "KASPA_NETWORK": "mainnet"
      }
    }
  }
}

工具

generate_mnemonic

生成一個新的 BIP39 助記詞，並派生相應的 Kaspa 錢包地址。

參數：

• wordCount（可選）：單詞數量 - 12 或 24（默認：12）
• network（可選）：地址派生的網絡 - mainnet、testnet-10 或 testnet-11（默認：mainnet）

返回值：

{
  mnemonic: string,    // 生成的 BIP39 助記詞
  address: string,     // 派生的 Kaspa 地址（賬戶 0）
  network: string,     // 使用的網絡
  warning: string      // 安全提醒
}

重要提示： 助記詞是使用加密安全的隨機數生成的。請安全保存 - 如果丟失將無法恢復。

get_my_address

獲取從你配置的私鑰或助記詞派生的 Kaspa 地址。

返回值： { address: string }

get_balance

獲取 Kaspa 地址的餘額。

參數：

• address（可選）：要檢查的地址。默認為你的錢包地址。

返回值： { address: string, balance: string, utxoCount: number }

get_fee_estimate

從網絡獲取當前的費用估算。

返回值： { priorityFee: string, normalFee: string, lowFee: string }

send_kaspa

向接收方發送 KAS 代幣。

參數：

• to：接收方的 Kaspa 地址（必須與錢包網絡匹配）
• amount：KAS 數量，以字符串形式表示（例如，"10.5"，最多 8 位小數）
• priorityFee（可選）：優先費用，以 sompi 為單位

返回值： { txId: string, fee: string }

驗證：

• 地址格式和網絡前綴驗證
• 金額必須是有效的正十進制數
• 最多 8 位小數（1 sompi = 0.00000001 KAS）
• 廣播前檢查餘額是否充足

get_transaction

獲取交易詳情，包括輸入和輸出。

參數：

• txId：交易 ID

返回值：

{
  txId: string,
  accepted: boolean,
  blockHash?: string,
  blockTime?: number,
  inputs: Array<{ transactionId: string, index: number }>,
  outputs: Array<{ index: number, amount: string, address: string }>
}

示例

測試提示

嘗試以下提示以驗證你的 MCP 是否正常工作：

"Generate a new Kaspa wallet for me"

"What is my Kaspa address?"

"How much KAS do I have?"

"What are the current network fees?"

"Send 5 KAS to kaspa:qz..."

MCP 將執行以下操作：

1. 驗證接收方地址是否與你的網絡匹配
2. 檢查你的餘額是否充足
3. 使用符合 KIP-9 的費用構建交易
4. 使用你的私鑰簽名
5. 通過公共節點廣播到網絡
6. 返回交易 ID

🔧 技術細節

• 使用 kaspa-wasm 進行加密操作
• 通過解析器連接到公共節點以實現自動節點發現
• 為助記詞錢包實現 BIP44 派生路徑 m/44'/111111'/account'
• 交易構建使用生成器進行符合 KIP-9 的 UTXO 管理

🔒 安全保障

• 私鑰和助記詞僅在本地用於簽名
• 密鑰從不發送到任何外部服務
• 錯誤消息經過清理，以防止機密信息洩露
• 所有交易都需要用戶通過 MCP 工具進行明確操作

💻 使用示例

測試命令

npm test

測試套件包括基於 Kaspium 錢包 的確定性測試向量，用於跨實現驗證。測試向量存儲在 src/kaspa/test-vectors.json 中，包括：

• 標準 BIP39 測試助記詞（12 和 24 個單詞）
• 已知私鑰 → 地址派生
• 無效輸入驗證

這些向量確保使用 BIP44 路徑 m/44'/111111'/account'/0/0 的 Kaspa 錢包實現之間的密鑰派生一致。

注意： 幣種類型 111111 是 Kaspa 的事實上的標準，被 rusty-kaspa（官方節點）、Kaspium 和 kaspa-wasm 使用。雖然未在 SLIP-0044 中正式註冊，但它是既定的生態系統約定。

網絡信息

📄 許可證

ISC