Каталог MCP
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

Инструменты были проиндексированы: 05.09.2026

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

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

Параметры

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

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-файлы (шарды) в текущем пространстве (продвинутое использование).

Параметры

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

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

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

Параметры

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

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

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":[]} — сначала убедитесь, что вы вошли в систему, прежде чем использовать другие инструменты.

Параметры

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

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. Автоматически не использует её для агента. Требует АБСОЛЮТНЫХ путей для аргументов-файлов.

Параметры

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

w3_usage_report

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

Параметры

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

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

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

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

Нужен npx

Сервер запускается через npx
Без него ничего работать не будет.

Как установить npx

FAQ

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

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

Что он умеет?

Сервер оборачивает w3 CLI от storacha.network: логинит по email, проверяет авторизацию, сбрасывает состояние агента. Управляет пространствами: переключает, просматривает, добавляет, привязывает к биллингу. Загружает и удаляет файлы, показывает список, генерирует публичные ссылки w3s.link. Работает с делегациями и доказательствами доступа, выпускает ключи и токены для UCAN-HTTP моста. На продвинутом уровне управляет блобами, CAR-хранилищами, аплоадами и индексами, показывает информацию о сделках Filecoin, тарифных планах и расходе хранилища.

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

Номер в рейтинге: #196
Звезд на Github: 21
Форков на Github: 17
Загрузок: 1 498
Язык реализации: TypeScript
Лицензия: MIT
Официальный сервер: Нет
Дата обновления данных: 05.09 в 00:09
Идентификатор: ZTLBi7Au_64xZTGS
Категории: Web3 и децентрализованные технологии, Автоматизация приложений, Блокчейн, Инструменты для разработчиков, Облачное хранилище, Файловые системы