Storacha MCP Storage Server

Storacha MCP ストレージサーバー

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

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

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

• GitHub ユーザー: GitHub アカウントでサインアップすると、すぐに100 MB の無料ストレージが提供されます。クレジットカードは必要ありません。
• メール ユーザー: メールで登録し、クレジットカードを追加すると、 5 GB の無料ストレージ スペースが利用できるようになります。

ユースケース

• ドキュメントの保存と分析: 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>新しいスペースの名前に置き換えます。:必要に応じて別のデバイスからスペースにアクセスできるように、回復キーを必ず保存してください。
   • 秘密鍵を作成する
     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モードを使用するには、以下の手順に従ってください。

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

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

ツール

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 サポートにアクセスするか、このリポジトリで問題を開いてください。