Storacha MCP ストレージサーバー

Storachaホットストレージ向けのモデルコンテキストプロトコル（MCP）サーバー実装。AIアプリケーションが標準化されたインターフェースを介してファイルを保存・取得できるようにします。IPFSとCIDを用いたトラストレスな分散型データ交換を可能にし、データ主権、検証可能性、そしてエージェントフレームワークやAIシステムとのシームレスな統合を保証します。

無料のストレージオプションから始めましょう🚀

今すぐ分散型ストレージの旅を始めましょう!

• GitHub ユーザー: GitHub アカウントでサインアップすると、すぐに100 MB の無料ストレージが提供されます。クレジットカードは必要ありません。

• メール ユーザー: メールで登録し、クレジットカードを追加すると、 5 GB の無料ストレージ スペースが利用できるようになります。

Related MCP server: MCP File Server

ユースケース

• ドキュメントの保存と分析: Blob ドキュメントを安全にアップロードおよび取得します。

• 長期構造化データ ストレージ: 長期性とアクセス性を考慮して最適化された構造化データ ストレージを維持します。

• エージェントとシステム間のデータ共有: **CID (コンテンツ識別子)**を使用して、複数のエージェントとさまざまなシステム間でデータを簡単に共有し、分散型で検証可能かつ効率的なデータ交換を可能にします。

• アプリケーション統合: モデル コンテキスト プロトコルを介して、Storacha ストレージ取得をアプリケーションにシームレスに統合します。

• AI モデル開発: Storacha に保存されている外部データセットへの信頼性の高いバージョン管理とアクセスを提供することで、AI モデルをサポートします。

• LLM 統合: Storacha ストレージに直接接続してシームレスなデータ アクセスを実現し、大規模言語モデル (LLM) を強化します。

• Web アプリケーションのバックアップ: 災害復旧のために Web アプリケーションのバックアップ コピーを確実に保存します。

• 機械学習データセット: 機械学習ワークフローで使用される大規模なデータセットを効率的に管理およびアクセスします。

クイックインストールガイド

わずか数ステップの簡単な手順で、Storacha MCP ストレージ サーバーの使用を開始できます。

1. リポジトリのクローンを作成する

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

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

   pnpm install

3. キーと委任の生成

   • CLIをインストールする

     npm install -g @web3-storage/w3cli

   • Storachaにログイン

     w3 login

     出力：

     ? How do you want to login?
       Via Email
     ❯ Via GitHub

     「GitHub 経由」を選択し、GitHub アカウントで認証します。

   • スペースを作成する

     w3 space create <your_space_name>

     <your_space_name>新しいスペースの名前に置き換えます。:warning:必要に応じて別のデバイスからスペースにアクセスできるように、回復キーを必ず保存してください。

   • 秘密鍵を作成する

     w3 key create

     出力：

     AgentId: did:key:z6MkhMZRW2aoJ6BQwkpMSJu68Jgqkz1FTpr1p69cpnN43YWG
     PrivateKey: LMgCYLkvOc8Sm0mOL4cWFLxsWP0ZPEYrLxcQqsV93/s5RLje0BKx05muAse1Hkvh+sxUW38OcHtpiN1zxfpTJ4ht4jxV0=

   • エージェントIDを設定して委任を作成する

     w3 delegation create <agent_id> \
      --can 'store/add' \
      --can 'filecoin/offer' \
      --can 'upload/add' \
      --can 'space/blob/add' \
      --can 'space/index/add' --base64

     <agent_id> を前の手順で取得した AgentId に置き換えます。これにより、エージェントに、先ほど作成したスペースにファイルを保存する権限が付与されます。

4. MCPクライアントを構成する

   次に、このサーバーを使用するようにMCPクライアント（Cursorなど）を設定します。ほとんどのMCPクライアントは、設定を以下の形式のJSON形式で保存します。

   {
     "mcpServers": {
       "storacha-storage-server": {
         "command": "node",
         "args": ["./dist/index.js"],
         "env": {
           // The server supports `stdio`, `sse`, and `rest` modes, the default is `stdio`.
           "MCP_TRANSPORT_MODE": "stdio",
           // The Storacha Agent private key that is authorized to store data into the Space.
           "PRIVATE_KEY": "<agent_private_key>",
           // The base64 encoded delegation that proves the Agent is allowed to store data. If not set, MUST be provided for each upload request.
           "DELEGATION": "<base64_delegation>",
         },
         "shell": true,
         "cwd": "./",
       },
     },
   }

   <agent_private_key>を、手順 3 で作成した PrivateKey に置き換えます。次に、 <base64_delegation>を、手順 3 で作成した委任に置き換えます。

RESTモードとクラウドホスティング

Storacha MCPストレージサーバーは、MCP.soクラウドホスティングと互換性のあるRESTトランスポートモードをサポートしています。RESTモードを使用するには、以下の手順に従ってください。

{
  "mcpServers": {
    "storacha-storage-server-rest": {
      "url": "http://localhost:3001/rest",
    },
  },
}

MCP.so クラウドへのデプロイの詳細については、 integrations.mdガイドを参照してください。

:warning: MCP クライアントを構成する方法はいくつかあります。詳細については、 integrations.mdガイドをお読みください。

ツール

Storacha MCP ストレージ サーバーは、AI システムが分散型ストレージ ネットワークと対話するための次のツールを提供します。

ストレージ操作

アップロード

Storacha Network にファイルをアップロードします。ファイルは、MIME タイプ検出用の拡張子を含むファイル名を持つ、base64 エンコードされた文字列として提供する必要があります。

interface UploadParams {
  // Base64 encoded file content
  file: string;
  // Filename with extension for MIME type detection
  name: string;
  // Optional: Whether to publish to Filecoin (default: false)
  publishToFilecoin?: boolean;
  // Optional: Custom delegation proof
  delegation?: string;
  // Optional: Custom gateway URL
  gatewayUrl?: string;
}

取得する

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

interface RetrieveParams {
  // Path in format: CID/filename, /ipfs/CID/filename, or ipfs://CID/filename
  filepath: string;
  // Optional: Whether to use multiformat base64 encoding
  useMultiformatBase64?: boolean;
}

身元

秘密鍵ストレージ構成からロードされた Storacha エージェントのDIDKeyを返します。

interface IdentityParams {
  // No parameters required
}

詳細なコード例とさまざまな統合パターン (SDK、Docker など) については、 integrations.mdガイドを参照してください。

ライセンス

MIT または Apache 2 ライセンス

サポート

サポートについては、 Storacha サポートにアクセスするか、このリポジトリで問題を開いてください。