WalletMCP - Solana Blockchain MCP Server

WalletMCP - Solana ブロックチェーン MCP サーバー

WalletMCP は、Solana ブロックチェーンとやり取りするための Model Context Protocol（MCP）サーバー実装です。 MCP 対応インターフェースを通じて、ウォレット、トランザクション、プログラムバッファー、ログ、SOL の送金を操作するための、開発者向けツールを提供します。

📺 デモ動画

上の画像をクリックしてデモ動画を視聴

🧠 機能

• 🔍 ウォレットのトランザクションと SOL 残高を取得します。
• 📜 Solana ブロックチェーンからプログラムログにアクセスします。
• 🧾 未使用のレンタル料を回収します（BPF Upgradeable Loader のバッファーを一覧表示して閉じます）。
• 💸 SOL トランザクションをプログラムで送信します。
• 🧩 スキーマ検証に Zod を使用した、完全な MCP 準拠のツール定義を備えています。

🔧 使用技術

• Solana Web3.js SDK – Solana ブロックチェーンとのやり取り
• Model Context Protocol（MCP） – ツール登録用プロトコル
• Zod – 入力検証
• TypeScript – 強い型付けと最新のツール群

📋 必要条件

• Node.js v16+
• Yarn または npm

🚀 はじめに

1. リポジトリをクローンします

   git clone https://github.com/paulfruitful/WalletMCP
   

  ```bash
  cd walletMCP

2. 依存関係をインストールします

   npm install
   

3. MCP サーバーをビルドします

   npm run build
   

サーバーのテスト：

サーバーをテストするには、Claude Desktop MCP クライアントを使用できます。デスクトップアプリケーションをダウンロードするには、こちらをクリックしてください： Claude Desktop をダウンロード

Claude Desktop の場合

次のコマンドを実行して、Claude Desktop の設定ファイルを開きます

Windows の場合：

   code $env:AppData\Claude\claude_desktop_config.json

Mac/Linux の場合：

   code ~/Library/Application\ Support/Claude/claude_desktop_config.json

設定ファイルを開いたら、サーバーを追加します：

{
  "mcpServers": {
    "walletmcp": {
      "command": "node",
      "args": [
          "YOUR_PATH_PREFIX\\WalletMCP\\build\\index.js"
      ]
  }
  }
}

これで完了です！ Claude Desktop で、サーバーが提供するツールを使用できるようになります。 Solana ウォレットに関する質問をすることで、Claude クライアント上でこれらのツールを有効にできます。

質問やプロンプトの例：

• 「最近のトランザクションを教えてください」

• 「SOL はいくら持っていますか？」

• 「未使用のバッファーはいくつありますか？」

• 「アカウント [accountAddress] に SOL を送金できますか？」

• 「特定のプログラム [programId] のログを教えてください」

⚙️ ツールと説明

getTransactions

説明：ウォレットの最近のトランザクションを取得します。
入力：

• walletAddress（string）
• limit（number）- 取得するトランザクションの最大数。

getBalance

説明：ウォレットの SOL 残高を取得します。
入力：

• walletAddress（string）

listBuffers

説明：支払者のキーに関連付けられたプログラムバッファーを一覧表示します。
入力：

• payerKey（array of numbers）

closeBuffer

説明：バッファーを閉じて、lamports を支払者に返します。
入力：

• bufferPubkey（string）
• payerKey（array of numbers）

getProgramLogs

説明：特定のプログラム ID のトランザクションログを取得します。
入力：

• programId（string）
• limit（number）- 任意。デフォルトは 10

sendSolTransaction

説明：あるウォレットから別のウォレットに SOL を送金します。
入力：

• fromPrivateKey（array of numbers）
• toPublicKeyStr（string）
• amountSol（number）
• mode（"main" | "dev"）

🛡️ セキュリティに関する考慮事項

• 秘密鍵は常に安全に保管してください。
• キーはサーバーに保存されたり、ログに記録されたりしません。

🤝 コントリビューション

このプロジェクトでは、Solana 開発者コミュニティからのコントリビューションを歓迎しています。 改善案があれば、お気軽に issue を作成するか、プルリクエストを送信してください。