Storacha MCP ストレージサーバー

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

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

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

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

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

Related MCP server: MCP Toolkit

ユースケース

• ドキュメントの保存と分析: 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 経由」を

   • スペースを作成する

     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>

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

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

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

:warning: MCP クライアントを構成する方法はいくつかあります。詳細については、

ツール

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

ストレージ操作

アップロード

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

取得する

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

身元

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

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

ライセンス

MIT または Apache 2 ライセンス

サポート

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