Storacha MCP Storage Server

Free Storage Options to Start

• **GitHub Users**: Sign up with your GitHub account and instantly receive **100MB of free storage** no credit card required!

• **Email Users**: Register with your email and add a credit card to unlock **5GB of free storage space**.

Use Cases

• **Document Storage & Analysis**: Securely upload and retrieve Blob documents.

• **Long-term Structured Data Storage**: Maintain structured data storage optimized for longevity and accessibility.

• **Data Sharing Between Agents and Systems**: Easily share data across multiple agents and diverse systems using **CIDs (Content Identifiers)**, enabling decentralized, verifiable, and efficient data exchange.

• **Application Integration**: Seamlessly integrate Storacha storage retrieval into applications via the Model Context Protocol.

• **AI Model Development**: Support AI models by providing reliable versioning and access to external datasets stored in Storacha.

• **LLM Integration**: Enhance large language models (LLMs) by connecting directly with Storacha Storage for seamless data access.

• **Web Application Backups**: Reliably store backup copies of web applications for disaster recovery.

• **Machine Learning Datasets**: Efficiently manage and access large datasets used in machine learning workflows.

Quick Installation Guide

1. **Clone the Repository** ```bash git clone https://github.com/storacha/mcp-storage-server.git && cd mcp-storage-server ```

2. **Install Dependencies** ```bash pnpm install ```

3. **Generate Keys & Delegation** - **Install the CLI** ```bash npm install -g @web3-storage/w3cli ``` - **Login to Storacha** ```bash w3 login ``` _Output:_ ``` ? How do you want to login? Via Email Via GitHub ``` _Select **Via GitHub** and authenticate with your GitHub account._ - **Create a Space** ```bash w3 space create <your_space_name> ``` _Replace `<your_space_name>` with a name for your new Space_. :warning: _Make sure you save the recovery key, so you can access your space from another device if needed._ - **Create a Private Key** ```bash w3 key create ``` _Output:_ ```txt AgentId: did:key:z6MkhMZRW2aoJ6BQwkpMSJu68Jgqkz1FTpr1p69cpnN43YWG PrivateKey: LMgCYLkvOc8Sm0mOL4cWFLxsWP0ZPEYrLxcQqsV93/s5RLje0BKx05muAse1Hkvh+sxUW38OcHtpiN1zxfpTJ4ht4jxV0= ``` - **Set the Agent ID & Create Delegation** ```bash w3 delegation create <agent_id> \ --can 'store/add' \ --can 'filecoin/offer' \ --can 'upload/add' \ --can 'space/blob/add' \ --can 'space/index/add' --base64 ``` _Replace <agent_id> with the AgentId from the previous step. It grants the Agent the permission to store files into the recently created space_.

4. **Configure the MCP Client** Next, configure your MCP client (such as Cursor) to use this server. Most MCP clients store the configuration as JSON in the following format: ```jsonc { "mcpServers": { "storacha-storage-server": { "command": "node", "args": ["./dist/index.js"], "env": { // The server also supports `sse` mode, 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": "./", }, }, } ``` _Replace `<agent_private_key>` with the PrivateKey you created in step 3. Then, replace the `<base64_delegation>` with the delegation you created in step 3._ _:warning: There are several ways to configure MCP clients, please read the [integrations.md](https://github.com/storacha/mcp-storage-server/blob/main/docs/integrations.md) guide for more information._

Tools

Storage Operations

upload

retrieve

identity

License

Support