Walrus MCP

🚀 🦭 Walrus MCP Server

Walrus分散型ストレージプロトコルのMCPサーバーです。AIアシスタントと分散型ストレージネットワークをつなぐ橋渡しをします。

🚀 クイックスタート

前提条件

• Node.js >= 18.0.0
• npm >= 8.0.0
• Claude Desktop または互換性のあるMCPクライアント

インストール

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

   git clone https://github.com/MotionEcosystem/walrus-mcp.git
   cd walrus-mcp
   

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

   npm install
   

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

   npm run build
   

MCPの設定

Claude Desktopの設定に以下を追加します。

{
  "mcpServers": {
    "walrus": {
      "command": "node",
      "args": ["path/to/walrus-mcp/dist/index.js"],
      "env": {
        "WALRUS_AGGREGATOR_URL": "https://aggregator-devnet.walrus.space",
        "WALRUS_PUBLISHER_URL": "https://publisher-devnet.walrus.space"
      }
    }
  }
}

✨ 主な機能

🗄️ 分散型ストレージ操作

• Walrus分散型ストレージネットワークにブロブを保存します。
• ブロブIDを使用してブロブを取得し、高い可用性を保証します。
• サイズや認証ステータスを含むブロブ情報を取得します。
• ブロブの可用性とネットワークの健全性を確認します。

🔗 ブロックチェーン統合

• ストレージメタデータのためのSuiブロックチェーンの調整
• ブロブのライフサイクルのためのストレージエポック管理
• ブロックチェーン検証による可用性の証明
• ストレージリソース管理

🛠️ 開発者向け機能

• AIアシスタントと自動化のためのシンプルなMCPツール
• バイナリデータの処理のためのBase64エンコーディング
• 直接のファイルアップロードのためのファイルパスのサポート
• 明確なメッセージを伴う包括的なエラー処理

🛠️ 利用可能なツール

store_blob

Walrus分散型ストレージにデータを保存します。

• data: Base64エンコードされたデータまたはファイルパス
• epochs (オプション): 保存するエポック数 (デフォルト: 5)

get_blob

Walrusストレージからブロブを取得します。

• blobId: 取得するブロブのID

get_blob_info

ブロブに関する情報を取得します。

• blobId: 情報を取得するブロブのID

list_blobs

保存されたブロブをリストします (ローカルインデックスが必要)。

• limit (オプション): リストする最大ブロブ数

delete_blob

ブロブの削除を試みます (注: Walrusのブロブは自動的に期限切れになります)。

• blobId: 削除するブロブのID

📊 リソース

walrus://status

Walrusネットワークの現在のステータスと健全性

walrus://config

現在のWalrusクライアントの設定

🔧 開発

利用可能なスクリプト

技術スタック

• ランタイム: Node.js
• 言語: TypeScript
• MCP SDK: @modelcontextprotocol/sdk
• HTTPクライアント: Axios
• バリデーション: Zod

🏗️ アーキテクチャ

Walrus MCPサーバーは、Model Context Protocol (MCP) を通じてAIアシスタントとWalrus分散型ストレージネットワークの橋渡しをします。

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   AI Assistant  │    │  Walrus MCP     │    │ Walrus Network  │
│  (Claude, etc.) │◄──►│     Server      │◄──►│   (DevNet)      │
└─────────────────┘    └─────────────────┘    └─────────────────┘
                              │
                              ▼
                       ┌─────────────────┐
                       │  Sui Blockchain │
                       │   (Metadata)    │
                       └─────────────────┘

コンポーネント

• MCP Server: AIアシスタントからのツール呼び出しとリソース要求を処理します。
• Walrus Client: WalrusアグリゲーターとパブリッシャーとのHTTP通信を管理します。
• Aggregator: ブロブの取得機能を提供します。
• Publisher: ブロブの保存操作を処理します。
• Sui Integration: ストレージメタデータとエポックを管理します。

📚 詳細ドキュメント

環境設定

.env.exampleに基づいて.envファイルを作成します。

# 必須: Walrusネットワークのエンドポイント
WALRUS_AGGREGATOR_URL=https://aggregator-devnet.walrus.space
WALRUS_PUBLISHER_URL=https://publisher-devnet.walrus.space

# オプション: カスタムシステムオブジェクトID
WALRUS_SYSTEM_OBJECT=0x37c0e4d7b36a2f64d51bba262a1791f844cfd88f19c35b5ca709e1a6991e90dc

# オプション: トランザクション署名用のウォレット
WALRUS_WALLET_PATH=/path/to/your/wallet.json

ツールの使用例

ブロブの保存

// テキストデータを保存
await tool_call("store_blob", {
  data: "SGVsbG8sIFdhbHJ1cyE=", // Base64エンコードされた "Hello, Walrus!"
  epochs: 10
})

// ファイルを保存
await tool_call("store_blob", {
  data: "/path/to/file.jpg",
  epochs: 5
})

ブロブの取得

// ブロブの内容をBase64として取得
const blob = await tool_call("get_blob", {
  blobId: "0xabc123..."
})

ブロブ情報の取得

// ブロブのメタデータを取得
const info = await tool_call("get_blob_info", {
  blobId: "0xabc123..."
})

console.log(info.size, info.certified, info.endEpoch)

リソースの使用例

ネットワークステータスの確認

// Walrusネットワークの健全性を取得
const status = await resource_read("walrus://status")
console.log(status.epoch, status.networkSize)

設定の表示

// 現在のクライアント設定を取得
const config = await resource_read("walrus://config")
console.log(config.aggregatorUrl, config.publisherUrl)

エラー処理

サーバーは一般的なシナリオに対する包括的なエラー処理を提供します。

• ブロブが見つからない: ブロブIDを含む明確なエラーメッセージ
• ネットワーク問題: タイムアウトと接続性のエラー詳細
• 無効なデータ: 不正な入力に対するバリデーションエラー
• ストレージ制限: エポックと容量の制約メッセージ

データ形式のサポート

サポートされる入力形式

• Base64エンコードされた文字列: バイナリデータの送信に使用
• ファイルパス: 直接のファイル読み取り (相対または絶対)
• テキストコンテンツ: 自動的に保存のためにエンコードされます

出力形式

取得されたすべてのブロブは、さまざまなデータ型にわたって一貫した処理のためにBase64エンコードされた文字列として返されます。

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

⚠️ 重要なセキュリティ注意事項

• Walrusに保存されるすべてのブロブは公開され、検索可能です。
• 暗号化なしで機密情報を保存しないでください。
• プライベートデータにはクライアント側の暗号化を検討してください。
• 処理する前にすべての入力を検証してください。

ネットワーク情報

DevNet設定

• Aggregator: https://aggregator-devnet.walrus.space
• Publisher: https://publisher-devnet.walrus.space
• System Object: 0x37c0e4d7b36a2f64d51bba262a1791f844cfd88f19c35b5ca709e1a6991e90dc

TestNet設定

TestNetを使用する場合は、環境変数を更新します。

WALRUS_AGGREGATOR_URL=https://aggregator-testnet.walrus.space
WALRUS_PUBLISHER_URL=https://publisher-testnet.walrus.space

ストレージ経済学

エポックと価格設定

• エポック期間: ストレージのコミットメントのための固定時間帯
• 最小ストレージ: 5エポック (設定可能)
• コスト計算: ブロブのサイズと保存期間に基づく
• 支払い: Suiブロックチェーントランザクションを通じて処理されます。

トラブルシューティング

一般的な問題

1. 接続エラー
   • ネットワーク接続を確認します。
   • アグリゲーター/パブリッシャーのURLを確認します。
   • DevNet/TestNetのエンドポイントがアクセス可能か確認します。
2. 保存失敗
   • ブロブのサイズ制限を確認します。
   • 保存料金に十分なSUIトークンがあることを確認します。
   • 適切なエポック設定を確認します。
3. 取得問題
   • ブロブIDの形式と有効性を確認します。
   • ブロブが期限切れになっていないことを確認します (終了エポックを過ぎていないこと)。
   • アグリゲーターの可用性を確認します。

デバッグモード

詳細なログを有効にします。

DEBUG=walrus-mcp:* npm run dev

コントリビューション

コントリビューションを歓迎します！以下の手順に従ってください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します。
3. 新機能のテストを追加します。
4. ドキュメントを更新します。
5. プルリクエストを送信します。

ロードマップ

• [ ] 強化されたブロブ管理: バッチ操作とメタデータインデックス
• [ ] 暗号化サポート: プライベートデータのクライアント側暗号化
• [ ] WebSocketサポート: リアルタイムのブロブステータス更新
• [ ] CLIツール: スタンドアロンのコマンドラインインターフェイス
• [ ] パフォーマンスメトリクス: ストレージと取得の分析
• [ ] MainNetサポート: 本番ネットワークの統合

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

🤝 サポート

• ドキュメント: Walrus公式ドキュメント
• コミュニティ: Motion Labs Discord
• 問題報告: GitHub Issues
• メール: hello@motionecosystem.com