Storacha

🚀 Storacha MCP Storage Server

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

🚀 Start with Free Storage Options Today

Embark on your decentralized storage journey today!

• GitHub Users: Sign up with your GitHub account and get 100MB of free storage — no credit card required!
• Email Users: Sign up via email and add a credit card to unlock 5GB of free storage.

✨ Features

• Document Storage and Analysis: Securely upload and retrieve blob documents.
• Long-term Structured Data Storage: Maintain structured data suitable for long-term preservation and access.
• Agent Interaction: Support seamless integration with agent frameworks and AI systems for flexible data management.

📦 Installation

Project Initialization

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

Configure the Storage Server

Edit the config.json file:

{
  "storage": {
    "provider": "ipfs",
    "nodeUrl": "http://localhost:5001"
  },
  "identity": {
    "privateKey": "your-private-key-here"
  }
}

Start the Server

npm start

📚 Documentation

The Storacha MCP Storage Server provides the following interaction tools for AI systems:

Storage Operations

Upload a File

Upload a file to the Storacha network. The file should be provided in base64-encoded format and include the file extension for MIME type detection.

interface UploadParams {
  // Base64-encoded file content
  file: string;
  // File name 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 a File

Retrieve a file from the Storacha network. Supported file path formats include: CID/filename, /ipfs/CID/filename, or ipfs://CID/filename.

interface RetrieveParams {
  // Path format: CID/