Каталог MCP
alexbakers
alexbakers/mcp-ipfs

alexbakers/mcp-ipfs

MCP-сервер для управления storacha.network через w3 CLI: авторизация, загрузка/скачивание данных, управление пространствами и делегирование доступа. Полезен разработчикам, работающим с IPFS и децен...

README

35 инструментов

Установить сервер

🪐 MCP IPFS Server (storacha.network) 🛰️

Screenshot

A Node.js server implementing the Model Context Protocol (MCP) for interacting with the storacha.network platform via the w3 command-line interface (@web3-storage/w3cli).

This server empowers language models 🤖 and other MCP clients to manage storacha.network spaces, upload/download data, manage delegations, and perform various other tasks by seamlessly wrapping w3 commands.

✨ Features

Wraps the w3 CLI for native integration with storacha.network.
Provides MCP tools covering a wide range of w3 functionality:
- 🔑 Authentication & Agent: w3_login, w3_reset, w3_account_ls (for checking authorization)
- 📦 Space Management: w3_space_ls, w3_space_use, w3_space_info, w3_space_add, w3_space_provision (Note: w3_space_create must be run manually due to interactive prompts)
- 💾 Data Management: w3_up, w3_ls, w3_rm
- 🔗 Sharing: w3_open (generates w3s.link URL)
- 🤝 Delegations & Proofs: w3_delegation_create, w3_delegation_ls, w3_delegation_revoke, w3_proof_add, w3_proof_ls
- 🔐 Keys & Tokens: w3_key_create, w3_bridge_generate_tokens
- ⚙️ Advanced Storage (w3 can ...): Blob, CAR, Upload, Index, Access Claim, Filecoin Info management
- 💳 Account & Billing: w3_plan_get, w3_coupon_create, w3_usage_report

w3_account_ls

Перечисляет все учетные записи, для которых текущий агент **авторизован**. Используйте эту команду после `w3_login` и проверки электронной почты, чтобы убедиться, что агент успешно привязан к вашей учетной записи (учетным записям) storacha.network. **Примечание:** Состояние агента может быть эфемерным (например, в Docker). Проверьте статус авторизации с помощью этой команды после (повторного) подключения и используйте `w3_login` при необходимости.

Параметры

Без параметров.

w3_bridge_generate_tokens

Генерирует токены аутентификации для использования UCAN-HTTP bridge.

Параметры

capabilitiesstring[]обязательный
One or more capabilities to delegate (e.g., ['space/info']).
expirationinteger
Unix timestamp (in seconds) for expiration. Zero means no expiration.
jsonboolean
Output JSON suitable for fetch headers (default: true).

w3_can_access_claim

Получает делегированные возможности для авторизованной учетной записи, используя предоставленное доказательство.

Параметры

proofstringобязательный
Delegation proof (e.g., path to CAR file or base64 CID string) containing capabilities to claim.

w3_can_blob_add

Сохраняет один файл как blob напрямую в сервисе. Требует АБСОЛЮТНЫХ путей для файловых аргументов.

Параметры

pathstringобязательный
ABSOLUTE path to the blob file to store.

w3_can_blob_ls

Перечисляет блобы, хранящиеся в текущем пространстве.

Параметры

jsonboolean
Format output as newline delimited JSON (default: true).
sizeinteger
Desired number of results to return.
cursorstring
Opaque cursor string from a previous response for pagination.

w3_can_blob_rm

Удаляет блоб из хранилища по его мультихешу, закодированному в base58btc.

Параметры

multihashstringобязательный
Base58btc encoded multihash of the blob to remove.

w3_can_filecoin_info

Получает информацию о сделках Filecoin для заданного Piece CID (продвинутое использование).

Параметры

pieceCidstringобязательный
The Piece CID to get Filecoin information for.

w3_can_index_add

Регистрирует CID индекса в сервисе (продвинутое использование). Обратитесь к документации storacha.network за подробностями об индексах.

Параметры

cidstringобязательный
CID of the index to add.

w3_can_store_add

Сохраняет CAR-файл в сервисе (продвинутое использование). Часто это необходимо для `w3_can_upload_add`. Требует АБСОЛЮТНЫХ путей для аргументов файлов.

Параметры

pathstringобязательный
ABSOLUTE path to the CAR file to store.

w3_can_store_ls

Перечисляет сохранённые CAR-файлы (шарды) в текущем пространстве (продвинутое использование).

Параметры

jsonboolean
Format output as newline delimited JSON (default: true).
sizeinteger
Desired number of results to return.
cursorstring
Opaque cursor string from a previous response for pagination.

w3_can_store_rm

Удаляет сохранённый shard CAR по его CID (продвинутое использование). Используйте с крайней осторожностью, так как это удаляет базовый shard данных.

Параметры

carCidstringобязательный
CID of the CAR shard to remove from the store.

w3_can_upload_add

Регистрирует вручную DAG загрузки по его корневому CID и CID шардов (продвинутое использование). Обычно используется после ручного сохранения CAR-шардов.

Параметры

rootCidstringобязательный
Root data CID of the DAG to register.
shardCidsstring[]обязательный
One or more shard CIDs where the DAG data is stored.

w3_can_upload_ls

Перечисляет загрузки, зарегистрированные в текущем пространстве (расширенный вид, показывает базовую структуру).

Параметры

jsonboolean
Format output as newline delimited JSON (default: true).
shardsboolean
Pretty print with shards in output (ignored if --json is true).
sizeinteger
Desired number of results to return.
cursorstring
Opaque cursor string from a previous response for pagination.
preboolean
Return the page of results preceding the cursor.

w3_can_upload_rm

Удаляет информацию о загрузке по её корневому CID (для продвинутого использования). Не удаляет базовые блобы/шарды.

Параметры

rootCidstringобязательный
Root CID of the upload to remove from the list.

w3_coupon_create

Пытается создать/активировать купон с использованием кода активации.

Параметры

claimCodestringобязательный
The claim code for the coupon.

w3_delegation_create

Параметры

audienceDidstringобязательный
The DID of the audience receiving the delegation (e.g., did:key:...).
capabilitiesstring[]обязательный
One or more capabilities to delegate (e.g., ['space/*', 'upload/*']).
namestring
Human-readable name for the audience.
typeenum
Type of the audience.
deviceappservice
outputstring
ABSOLUTE path of file to write the exported delegation CAR file to.
base64boolean
Format output as base64 identity CID string instead of writing to a file.

w3_delegation_ls

Инструмент для операции w3_delegation_ls.

Параметры

jsonboolean
Format output as newline delimited JSON (default: true).

w3_delegation_revoke

Инструмент для операции w3_delegation_revoke. Требует АБСОЛЮТНЫЕ пути для аргументов файлов.

Параметры

delegationCidstringобязательный
The CID of the delegation to revoke.
proofstring
ABSOLUTE path to a file containing the delegation and any additional proofs needed.

w3_key_create

Генерирует и выводит новую пару ключей ed25519. Не использует её автоматически для агента.

Параметры

jsonboolean
Export the new key pair as dag-json (default: false).

w3_login

Запускает процесс входа w3, используя предварительно настроенный email (переменная окружения W3_LOGIN_EMAIL). ВАЖНО: Команда ожидает подтверждения по электронной почте, поэтому перед запуском инструмента `w3_login` подчеркните ВНИМАНИЕ пользователя крупными буквами + эмодзи, что он ОБЯЗАН проверить почту для завершения аутентификации. Если итоговый вывод содержит 'Agent was authorized by', пользователь уже перешел по ссылке и успешно авторизован, ПРОДОЛЖАЙТЕ использовать инструменты mcp-ipfs. 'Too Many Requests': подождите немного перед повторным запросом.

Параметры

Без параметров.

w3_ls

Выполняет операцию w3_ls.

Параметры

jsonboolean
Format output as newline delimited JSON (default: true).

w3_open

Инструмент для операции w3_open.

Параметры

cidstringобязательный
The CID of the content to open.
pathstring
Optional path within the content to append to the URL.

w3_plan_get

Отображает план для текущего или указанного аккаунта.

Параметры

accountIdstring
Optional account ID to get plan for (defaults to current authorized account).

w3_proof_add

Инструмент для операции w3_proof_add. Требует АБСОЛЮТНЫХ путей для файловых аргументов.

Параметры

proofPathstringобязательный
ABSOLUTE path to the CAR encoded proof file delegated to this agent.

w3_proof_ls

Инструмент для операции w3_proof_ls.

Параметры

jsonboolean
Format output as newline delimited JSON (default: true).

w3_reset

ОПАСНО: Сбрасывает состояние агента, удаляя все подтверждения и делегирования, но сохраняя DID агента. Требует явного аргумента подтверждения.

Параметры

confirmResetstringобязательный
Must be exactly 'yes-i-am-sure' to confirm resetting agent state (removes proofs/delegations).

w3_rm

Инструмент для операции w3_rm.

Параметры

cidstringобязательный
Root Content CID (e.g., bafy...) to remove from the uploads listing.
removeShardsboolean
Also remove underlying shards from the store (default: false). Use with caution.

w3_space_add

Выполняет операцию w3_space_add.

Параметры

proofstringобязательный
Filesystem path to a CAR encoded UCAN proof, or a base64 identity CID string.

w3_space_create

Создает новое пространство с понятным именем. ПРИМЕЧАНИЕ: `w3 space create` не может быть запущен через MCP из-за интерактивных запросов ключа восстановления. Пожалуйста, выполните эту команду вручную в своем терминале.

Параметры

namestring
An optional user-friendly name for the new space.

w3_space_info

Инструмент для операции w3_space_info. ПРИМЕЧАНИЕ: `no current space and no space given` или `{"spaces":[]}` — сначала убедитесь, что вы вошли в систему, прежде чем использовать другие инструменты.

Параметры

spaceDidstring
Optional DID of the space to get info for (defaults to current space).
jsonboolean
Format output as newline delimited JSON (default: true).

w3_space_ls

Инструмент для операции w3_space_ls. ПРИМЕЧАНИЕ: `no current space and no space given` или `{"spaces":[]}` — сначала убедитесь, что вы вошли в систему, прежде чем использовать другие инструменты.

Параметры

Без параметров.

w3_space_provision

Связывает пространство с учётной записью клиента/плательщика.

Параметры

customerIdstringобязательный
Customer identifier (e.g., email or account DID) to associate the space with.
spaceDidstringобязательный
The DID of the space to provision.

w3_space_use

Инструмент для операции w3_space_use.

Параметры

spaceDidstringобязательный
The DID of the space to select (e.g., did:key:...).

w3_up

Генерирует и выводит новую пару ключей ed25519. Автоматически не использует её для агента. Требует АБСОЛЮТНЫХ путей для аргументов-файлов.

Параметры

pathsstring[]обязательный
Array of one or more ABSOLUTE paths to files or directories to upload.
noWrapboolean
Don't wrap input files with a directory.
hiddenboolean
Include paths starting with '.'.

w3_usage_report

Отображает отчёт об использовании хранилища для текущего или указанного пространства.

Параметры

spaceDidstring
Optional DID of the space to get usage for (defaults to current space).
jsonboolean
Format output as JSON (default: true).

Github Сайт сервера

Конфиг для установки сервера

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

Также alexbakers/mcp-ipfs можно установить в Cursor по ссылке автоматически.

FAQ

Для чего этот сервер?

Этот сервер нужен, чтобы AI-агенты и MCP-клиенты могли напрямую работать с децентрализованным хранилищем storacha.network (IPFS/Filecoin). Он оборачивает команды утилиты w3 в набор инструментов MCP: загружать файлы, просматривать содержимое пространств, управлять доступом и делегированием. Вместо ручного запуска CLI через терминал модель сама вызывает нужные операции по ходу задачи.

Что он умеет?

Управляет пространствами storacha.network: создаёт, переключает, просматривает информацию, связывает с аккаунтом. Загружает и скачивает файлы, удаляет их, генерирует публичные ссылки. Управляет делегациями и доказательствами: создаёт, отзывает, просматривает, добавляет. Работает с ключами и токенами аутентификации. Выполняет продвинутые операции с хранением - управляет блобами, CAR-файлами, регистрирует индексы и upload, получает данные Filecoin. Проверяет планы, купоны и отчёты об использовании.

Информация о сервере

Номер в рейтинге: #184
Звезд на Github: 19
Форков на Github: 14
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 17.07 в 02:08
Идентификатор: ZTLBi7Au_64xZTGS
Категории: Web3 и децентрализованные технологии, Автоматизация приложений, Блокчейн, Инструменты для разработчиков, Облачное хранилище, Файловые системы

Другие проверенные MCP-сервера

mendableai/firecrawl-mcp-server

Firecrawl MCP сервер для AI-агентов, которым нужен чистый контекст из живого веба. Ищет информацию, скрапит страницы в структурированные данные, кликает и навигирует. Работает с облаком и сам хостингом, поддерживает автоматические ретраи. Полезен разработчикам для исследований и автоматизации сбо...

bankless/onchain-mcp

официальный

MCP-сервер для доступа к on-chain данным через Bankless API. Позволяет AI-моделям читать контракты, получать события и транзакции на разных сетях. Полезен разработчикам блокчейн-приложений и AI-аге...

vectorize-io/hindsight

официальный

MCP сервер Hindsight наделяет AI-агентов долговременной памятью — они учатся на опыте, а не просто запоминают диалоги. Использует биомиметические структуры данных для извлечения фактов и ментальных моделей, превосходя по точности RAG и графы знаний. Подходит для персонализации чат-ботов и создани...

browserbase/mcp-server-browserbase

официальный

MCP сервер облачной автоматизации браузера Browserbase. Позволяет AI-агентам навигировать по сайтам, извлекать данные и выполнять действия. Полезен для RPA и веб-скрапинга. Доступен self-hosted и hosted.

ravitemer/mcphub.nvim

MCP Hub — MCP клиент для Neovim, интегрирующий серверы MCP в редактор. Управляйте инструментами, ресурсами и промптами, используйте с чат-плагинами (Avante, CodeCompanion). Подходит разработчикам, автоматизирующим код через AI.

jau123/MeiGen-AI-Design-MCP

MCP-сервер для генерации изображений и видео через ИИ. Работает в Claude Code, Cursor и других AI-инструментах, поддерживает 9 моделей и 1446 промптов. Параллельная генерация, управление стилями и ...