Log inSubmit server
MCP Ipfs logo

MCP Ipfs

by alexbakers

Manage Storacha spaces, uploads, delegations, proofs, and storage operations through MCP tools backed by the w3 CLI.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Ipfs

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "alexbakers-mcp-ipfs": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ipfs"
      ],
      "env": {
        "W3_LOGIN_EMAIL": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y mcp-ipfs

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 23d ago.

Overview

The alexbakers/mcp-ipfs MCP server exposes Storacha Network operations to MCP clients through a Node.js wrapper around the w3 CLI. It supports authentication, space management, file uploads and downloads, sharing links, delegations, proofs, keys, tokens, and account operations. Use it when an agent needs to manage Storacha-backed IPFS storage while retaining the w3 CLI as the execution layer. It requires Node.js 22 or newer, a globally installed and configured w3 CLI, and W3_LOGIN_EMAIL for the login tool.

Use cases

  • Upload files to Storacha spaces
  • Inspect and switch between Storacha spaces
  • Create and manage delegations and proofs
  • Generate shareable w3s.link URLs
  • Review storage plans and usage

Key features

  • Wraps the Storacha w3 CLI as MCP tools
  • Manages spaces, uploads, listings, and removals
  • Creates and administers delegations and proofs
  • Supports keys, bridge tokens, and account operations
  • Exposes advanced blob, CAR, upload, index, and Filecoin commands
  • Runs through npx, a local Node.js build, or Docker

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 2d ago

Recent health check succeeded.

5/5 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 11d ago via OSV.dev · mcp-ipfs (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars21Stargazers on the source repository.
npm downloads189Package downloads in the last 30 days.
Last commit1y agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Ipfs works

What alexbakers/mcp-ipfs MCP server does

The alexbakers/mcp-ipfs MCP server connects MCP-compatible clients to the storacha.network platform through the @web3-storage/w3cli command-line interface. Instead of implementing storage operations independently, it translates MCP tool calls into w3 commands and returns their results to the client.

Its scope covers more than uploading files. Agents can inspect and select Storacha spaces, add or provision spaces, upload and list data, remove data, create public w3s.link URLs, and work with delegations and proofs. The server also exposes tools for account authorization, key creation, bridge token generation, plan and usage information, coupons, and several advanced w3 can ... storage operations.

How it works

The server runs as a Node.js process and communicates with an MCP client using the client’s standard server configuration. Each tool has a defined input schema, and the implementation invokes the corresponding w3 command. The underlying CLI must already be installed and authenticated outside the MCP tool layer.

Install the w3 CLI globally, run w3 login with the Storacha account email, and complete the email verification flow before using storage tools. The w3_login tool also expects W3_LOGIN_EMAIL to contain the same email address. The w3_space_create operation is not wrapped for normal automated use because it requires interactive prompts; it must be run manually.

Setup and configuration

The alexbakers/mcp-ipfs MCP server requires Node.js 22.0.0 or later and a working npm installation. For local use, an MCP client can launch it with npx -y mcp-ipfs and pass W3_LOGIN_EMAIL in the server environment. A built checkout can be installed with npm install, compiled with npm run build, and started with node dist/index.js.

Docker is also supported. The published image is alexbakers/mcp-ipfs, or the image can be built locally. When running in Docker, mount host directories that contain files the agent must upload or read. Tool arguments must use absolute paths visible inside the container, not paths that exist only on the host. The same path rule applies to upload, delegation output, proof, blob, and store operations.

Tools and capabilities

Available tool groups include:

  • Authentication and agent state: w3_login, w3_reset, and w3_account_ls.
  • Spaces: w3_space_ls, w3_space_use, w3_space_info, w3_space_add, and w3_space_provision.
  • Data: w3_up, w3_ls, and w3_rm.
  • Sharing: w3_open for generating a w3s.link URL.
  • Delegations and proofs: create, list, revoke, add, and inspect operations.
  • Keys and tokens: w3_key_create and w3_bridge_generate_tokens.
  • Advanced storage: blob, CAR, upload, index, access claim, and Filecoin information commands.
  • Account and billing: plan details, coupon creation, and usage reports.

The exact arguments are defined by the server’s tool schemas. Operations involving local files require paths accessible to the process that runs the server.

Limitations and notes

This server depends on the external w3 CLI and Storacha account configuration, so it is not a standalone IPFS node or independent storage implementation. Authentication must be completed through the w3 workflow, and the login tool depends on W3_LOGIN_EMAIL. Interactive space creation is intentionally outside the automated tool set. Containerized deployments also need explicit volume mounts for host files.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Ipfs

alexbakers/mcp-ipfs is an MCP server that connects MCP clients to storacha.network through the w3 CLI. Its main tools manage authentication, spaces, uploads, listings, removals, sharing links, delegations, proofs, keys, tokens, advanced storage operations, and account or billing information.

Install the prerequisites, then run it with npx or build it from source. Node.js 22 or newer and the globally installed @web3-storage/w3cli package are required. Authenticate with w3 login, set W3_LOGIN_EMAIL, and configure the MCP client to launch npx -y mcp-ipfs.

Yes, alexbakers/mcp-ipfs works with Cursor if it is configured as an MCP-compatible server. Use the standard command configuration with npx -y mcp-ipfs and provide W3_LOGIN_EMAIL in the server environment.

Mount the host directory into the container and pass the mounted location as an absolute path to the upload tool. Dockerized runs cannot access arbitrary host paths unless they are included with a volume mapping such as -v /host/path:/container/path.

Related MCP servers

All in Cloud Platforms All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Ipfs AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/alexbakers-mcp-ipfs?style=directory)](https://allmcps.com/mcp/alexbakers-mcp-ipfs)
HTML Embed
<a href="https://allmcps.com/mcp/alexbakers-mcp-ipfs"><img src="https://allmcps.com/api/badge/alexbakers-mcp-ipfs?style=directory" alt="MCP Ipfs on AllMCPs" /></a>