Query Mind Server

Storacha MCP ストレージサーバー

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

無料ストレージの利用を始めましょう 🚀

今日から分散型ストレージの利用を始めましょう！

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

ユースケース

• ドキュメントの保存と分析：Blob ドキュメントを安全にアップロード、取得します。
• 長期的な構造化データの保存：長期保存とアクセシビリティに最適化された構造化データストレージを維持します。
• エージェントやシステム間でのデータ共有：**CID（コンテンツ識別子）**を使用して、複数のエージェントやさまざまなシステム間でデータを簡単に共有でき、分散型で検証可能、かつ効率的なデータ交換を実現します。
• アプリケーションとの統合：Model Context Protocol を通じて、アプリケーションに Storacha ストレージのデータ取得機能をシームレスに統合します。
• AI モデルの開発：Storacha に保存された外部データセットへの信頼性の高いバージョン管理とアクセスを提供し、AI モデルをサポートします。
• LLM の統合：Storacha Storage に直接接続してシームレスなデータアクセスを実現し、大規模言語モデル（LLM）を強化します。
• ウェブアプリケーションのバックアップ：ウェブアプリケーションのバックアップコピーを確実に保存し、災害復旧に備えます。
• 機械学習データセット：機械学習ワークフローで使用する大規模データセットを効率的に管理し、アクセスします。

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

いくつかの簡単な手順で、Storacha MCP Storage Server を使い始められます。

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
     

     Via 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 Storage Server は、MCP.so のクラウドホスティングと互換性のある REST トランスポートモードをサポートしています。REST モードを使用するには、次の手順を実行します。

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

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

   :warning: MCP クライアントの設定方法はいくつかあります。詳しくは、integrations.md ガイドをご覧ください。

ツール

Storacha MCP Storage Server は、AI システムが分散型ストレージネットワークとやり取りするための以下のツールを提供します。

ストレージ操作

upload

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;
}

retrieve

Storacha Network からファイルを取得します。サポートされているファイルパスの形式は、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;
}

identity

秘密鍵のストレージ設定から読み込まれた Storacha エージェントの DIDKey を返します。

interface IdentityParams {
  // No parameters required
}

コード例やさまざまな統合パターン（SDK、Docker など）について詳しくは、integrations.md ガイドをご覧ください。

ライセンス

MIT または Apache 2 ライセンス

サポート

サポートについては、Storacha サポートをご利用いただくか、このリポジトリで Issue を作成してください。