mcp-ipfs

Overview

This MCP server implements the Model Context Protocol to provide access to IPFS functionality through the storacha.network platform. It wraps the w3 CLI, exposing various tools for space management, data operations, delegations, and account management. The server is written in TypeScript with a well-organized codebase that includes proper schemas for tool arguments and implementations for each MCP tool.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• w3_login

  Authenticate with storacha.network using the email specified in W3_LOGIN_EMAIL

  Try:Log me into storacha.networkTry:Sign in with my account
• w3_space_ls

  List all available spaces in the current storacha network account

  Try:Show me all my spacesTry:List available storage spaces
• w3_space_use

  Set the current active space for subsequent operations

  Try:Set my current space to my-projectTry:Switch to work space
• w3_space_info

  Retrieve information about a specific space

  Try:Show details for my main spaceTry:Get info about project space
• w3_up

  Upload files or directories to the current space

  Try:Upload my documents folderTry:Send this file to IPFS
• w3_ls

  List the contents of the current space

  Try:What files are in my space?Try:Show me all uploads
• w3_open

  Generate a w3s.link URL for accessing content in the current space

  Try:Create a shareable link for my fileTry:Get a URL for this upload
• w3_delegation_create

  Create a delegation to grant access to specific space content

  Try:Create a delegation for my colleagueTry:Share access to my files
• w3_key_create

  Create a new key for access to storacha network services

  Try:Generate a new API keyTry:Create access credentials
• w3_plan_get

  Retrieve information about the current account plan

  Try:What plan am I on?Try:Show my subscription details
• w3_usage_report

  Generate a usage report for the current account

  Try:Show my storage usageTry:Generate a usage report
• w3_rm

  Remove files from the current space

  Try:Delete old filesTry:Remove temporary uploads

Comparable tools

Installation

{
  "mcpServers": {
    "ipfs": {
      "command": "npx",
      "args": ["-y", "mcp-ipfs"],
      "env": {
        "W3_LOGIN_EMAIL": "your-email@example.com"
      }
    }
  }
}

FAQ

Why do I need to provide absolute paths for some commands?

Several w3 commands require absolute filesystem paths for proper operation, especially when working with files for upload or delegation creation.

Can I use this server with Docker?

Yes, the project provides a Docker image (alexbakers/mcp-ipfs) and includes Docker usage instructions in the README.

Compare mcp-ipfs with