Kaspa MCP

🚀 Kaspa MCP

KaspaブロックDAG上でKASを送信するためのMCPサーバーです。

📚 カスパについて

Kaspa は、プルーフ・オブ・ワーク（PoW）に基づき、GHOSTDAGプロトコルという新しいコンセンサスメカニズムを搭載した高速でスケーラブルなレイヤー1の暗号通貨です。GHOSTDAGは、従来のブロックチェーンが競合するブロックを破棄するのとは異なり、並列ブロックを共存させ、有向非巡回グラフ（ブロックDAG）内でそれらを順序付けることができます。これにより、分散化とセキュリティを維持しながら高いスループットを実現します。

主な特徴:

• 1秒間に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 を使用しています。
• Resolverを介してパブリックノードに接続し、自動的にノードを発見します。
• ニーモニックウォレットにはBIP44導出パス m/44'/111111'/account' を実装しています。
• トランザクションの構築には、KIP-9準拠のUTXO管理のためにGeneratorを使用しています。

🔒 セキュリティ

• 秘密鍵とニーモニックは署名のためにのみローカルで使用されます。
• 鍵は外部サービスに送信されることはありません。
• エラーメッセージは、秘密情報の漏洩を防ぐためにサニタイズされています。
• すべてのトランザクションは、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