Storacha

🚀 Storacha MCP ストレージサーバ

Storacha のホットストレージ用のモデルコンテキストプロトコル（MCP）サーバの実装です。これにより、AI アプリケーションは標準化されたインターフェースを通じてファイルの保存と取得が可能です。IPFS と CID を利用して分散型で信頼性の高いデータ交換を実現し、データの主権、検証可能性、およびエージェントフレームワークや AI システムとのシームレスな統合を保証します。

🚀 無料ストレージオプションですぐに始めよう

今日からあなたの分散型ストレージの旅を始めましょう！

• GitHub ユーザー：GitHub アカウントで登録すると、100MB の無料ストレージ容量を獲得できます。クレジットカードは不要です！
• メールユーザー：メールで登録し、クレジットカードを追加すると、5GB の無料ストレージ容量が利用可能になります。

✨ 主な機能

• ドキュメントの保存と分析：安全にブロブドキュメントをアップロードし、取得することができます。
• 長期的な構造化データの保存：長期保存とアクセスに適した構造化データを維持します。
• エージェントとのやり取り：エージェントフレームワークや AI システムとのシームレスな統合をサポートし、柔軟なデータ管理を実現します。

📦 インストール

プロジェクトの初期化

git clone https://github.com/storacha/mcp-storage-server.git
cd mcp-storage-server
npm install

ストレージサーバの設定

config.json ファイルを編集します。

{
  "storage": {
    "provider": "ipfs",
    "nodeUrl": "http://localhost:5001"
  },
  "identity": {
    "privateKey": "your-private-key-here"
  }
}

サーバの起動

npm start

💻 使用例

ストレージ操作

ファイルのアップロード

ファイルを Storacha ネットワークにアップロードします。ファイルは base64 エンコード形式で提供する必要があり、MIME タイプ検出のためにファイル拡張子を含める必要があります。

interface UploadParams {
  // Base64 エンコードされたファイル内容
  file: string;
  // MIME タイプ検出のための拡張子付きのファイル名
  name: string;
  // オプション：Filecoin に公開するかどうか（デフォルト：false）
  publishToFilecoin?: boolean;
  // オプション：カスタム委任証明
  delegation?: string;
  // オプション：カスタムゲートウェイ URL
  gatewayUrl?: string;
}

ファイルの取得

Storacha ネットワークからファイルを取得します。サポートされるファイルパス形式は CID/filename、/ipfs/CID/filename、または ipfs://CID/filename です。

interface RetrieveParams {
  // パス形式：CID/
  // （原文でこのインターフェース定義が途中で切れていましたが、そのまま保持）
}