Storacha MCP Storage Server

A Model Context Protocol (MCP) server implementation for Storacha hot storage, allowing AI applications to store and retrieve files through a standardized interface. It enables trustless, decentralized data exchange using IPFS and CIDs, ensuring data sovereignty, verifiability, and seamless integration with agent frameworks & AI systems.

Free Storage Options to Start 🚀

Jump-start your decentralized storage journey today!

• 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

Get started with the Storacha MCP Storage Server in just a few simple steps.

1. Clone the Repository

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

2. Install Dependencies

   pnpm install
   

3. Generate Keys & Delegation

   • Install the CLI

     npm install -g @web3-storage/w3cli
     

   • Login to Storacha

     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

     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

     w3 key create
     

     Output:

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

   • Set the Agent ID & Create Delegation

     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:

   {
     "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 base
   

... View full README on GitHub