Добавить сервер
alexbakers/mcp-ipfs
  1. Каталог MCP
  2. alexbakers/mcp-ipfs

alexbakers/mcp-ipfs

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

🪐 MCP IPFS Server (storacha.network) 🛰️

Screenshot

Publish Docker Publish NPM npm version smithery badge

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[]обязательный

    Одна или несколько возможностей для делегирования (например, ['space/info']).

  • expirationinteger

    Unix timestamp (в секундах) для истечения срока действия. Ноль означает, что срок действия не истекает.

  • jsonboolean

    Выводит JSON, подходящий для заголовков fetch (по умолчанию: true).

w3_can_access_claim

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

Параметры
  • proofstringобязательный

    Доказательство делегирования (например, путь к файлу CAR или base64-строка CID), содержащее полномочия для запроса.

w3_can_blob_add

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

Параметры
  • pathstringобязательный

    АБСОЛЮТНЫЙ путь к blob-файлу для хранения.

w3_can_blob_ls

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

Параметры
  • cursorstring

    Непрозрачная строка курсора из предыдущего ответа для пагинации.

  • jsonboolean

    Форматировать вывод как JSON, разделенный переводами строк (по умолчанию: true).

  • sizeinteger

    Желаемое количество возвращаемых результатов.

w3_can_blob_rm

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

Параметры
  • multihashstringобязательный

    Base58btc-кодированный multihash блоба для удаления.

w3_can_filecoin_info

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

Параметры
  • pieceCidstringобязательный

    Идентификатор Piece CID, для которого нужно получить информацию о Filecoin.

w3_can_index_add

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

Параметры
  • cidstringобязательный

    CID индекса, который нужно добавить.

w3_can_store_add

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

Параметры
  • pathstringобязательный

    АБСОЛЮТНЫЙ путь к CAR-файлу для сохранения.

w3_can_store_ls

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

Параметры
  • cursorstring

    Непрозрачная строка курсора из предыдущего ответа для пагинации.

  • jsonboolean

    Форматировать вывод как JSON, разделенный переводами строк (по умолчанию: true).

  • sizeinteger

    Желаемое количество возвращаемых результатов.

w3_can_store_rm

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

Параметры
  • carCidstringобязательный

    CID сегмента CAR, который нужно удалить из хранилища.

w3_can_upload_add

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

Параметры
  • rootCidstringобязательный

    Translation: Корневой CID данных DAG для регистрации.

  • shardCidsstring[]обязательный

    Один или несколько шардов CIDs, где хранятся данные DAG.

w3_can_upload_ls

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

Параметры
  • cursorstring

    Непрозрачная строка курсора из предыдущего ответа для пагинации.

  • jsonboolean

    Форматировать вывод как JSON, разделенный переводами строк (по умолчанию: true).

  • preboolean

    Возвращает страницу результатов, предшествующую курсору.

  • shardsboolean

    Красиво форматирует вывод с шардами (игнорируется, если --json равно true).

  • sizeinteger

    Желаемое количество возвращаемых результатов.

w3_can_upload_rm

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

Параметры
  • rootCidstringобязательный

    Корневой CID загрузки, которую нужно удалить из списка.

w3_coupon_create

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

Параметры
  • claimCodestringобязательный

    Код активации для купона.

w3_delegation_create
Параметры
  • audienceDidstringобязательный

    DID аудитории, получающей делегирование (например, did:key:...).

  • base64boolean

    Форматирует вывод в виде строки CID с identity-кодировкой base64 вместо записи в файл.

  • capabilitiesstring[]обязательный

    Одна или несколько возможностей для делегирования (например, ['space/', 'upload/']).

  • namestring

    Понятное человеку имя для аудитории.

  • outputstring

    Абсолютный путь к файлу, куда записать экспортированный делегационный CAR-файл.

  • typeenum

    Тип аудитории.

w3_delegation_ls

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

Параметры
  • jsonboolean

    Форматировать вывод как JSON, разделенный переводами строк (по умолчанию: true).

w3_delegation_revoke

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

Параметры
  • delegationCidstringобязательный

    CID делегирования, которое нужно отозвать.

  • proofstring

    АБСОЛЮТНЫЙ путь к файлу, содержащему делегирование и любые дополнительные доказательства, которые нужны.

w3_key_create

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

Параметры
  • jsonboolean

    Экспортируйте новую пару ключей в формате dag-json (по умолчанию: false).

w3_login

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

Параметры

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

w3_ls

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

Параметры
  • jsonboolean

    Форматировать вывод как JSON, разделенный переводами строк (по умолчанию: true).

w3_open

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

Параметры
  • cidstringобязательный

    CID контента, который нужно открыть.

  • pathstring

    Необязательный путь внутри контента, который добавляется к URL.

w3_plan_get

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

Параметры
  • accountIdstring

    Необязательный идентификатор аккаунта для получения тарифа (по умолчанию используется текущий авторизованный аккаунт).

w3_proof_add

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

Параметры
  • proofPathstringобязательный

    Абсолютный путь к файлу доказательства в формате CAR, переданному этому агенту.

w3_proof_ls

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

Параметры
  • jsonboolean

    Форматировать вывод как JSON, разделенный переводами строк (по умолчанию: true).

w3_reset

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

Параметры
  • confirmResetstringобязательный

    Должно быть точно 'yes-i-am-sure', чтобы подтвердить сброс состояния агента (удаляет доказательства/делегации).

w3_rm

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

Параметры
  • cidstringобязательный

    Корневой Content CID (например, bafy...), который нужно удалить из списка загрузок.

  • removeShardsboolean

    Также удаляет нижележащие шарды из хранилища (по умолчанию: false). Используйте с осторожностью.

w3_space_add

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

Параметры
  • proofstringобязательный

    Путь в файловой системе к доказательству UCAN, закодированному в CAR, или строка CID идентичности в base64.

w3_space_create

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

Параметры
  • namestring

    Необязательное понятное имя для нового пространства.

w3_space_info

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

Параметры
  • jsonboolean

    Форматировать вывод как JSON, разделенный переводами строк (по умолчанию: true).

  • spaceDidstring

    Необязательный DID пространства, для которого нужно получить информацию (по умолчанию — текущее пространство).

w3_space_ls

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

Параметры

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

w3_space_provision

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

Параметры
  • customerIdstringобязательный

    Идентификатор клиента (например, email или account DID), с которым связывается пространство.

  • spaceDidstringобязательный

    DID пространства для предоставления.

w3_space_use

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

Параметры
  • spaceDidstringобязательный

    DID пространства, которое нужно выбрать (например, did:key:...).

w3_up

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

Параметры
  • hiddenboolean

    Включайте пути, начинающиеся с точки.

  • noWrapboolean

    Не оборачивай входные файлы в каталог.

  • pathsstring[]обязательный

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

w3_usage_report

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

Параметры
  • jsonboolean

    Форматируй вывод как JSON (по умолчанию: true).

  • spaceDidstring

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

0.1.9основная
0.1.8
0.1.7
0.1.6
0.1.5
0.1.4
0.1.3
0.1.2
0.1.1
0.1.0

Выберите клиент, чтобы установить alexbakers/mcp-ipfs:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

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

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

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

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "alexbakers-mcp-ipfs-95wu8kol2j": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-ipfs"
      ],
      "env": {
        "W3_LOGIN_EMAIL": "your-email@example.com"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"alexbakers-mcp-ipfs-95wu8kol2j\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"mcp-ipfs\"],\"env\":{\"W3_LOGIN_EMAIL\":\"your-email@example.com\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "alexbakers-mcp-ipfs-95wu8kol2j": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ipfs"
      ],
      "env": {
        "W3_LOGIN_EMAIL": "your-email@example.com"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

claude mcp add alexbakers-mcp-ipfs-95wu8kol2j --env W3_LOGIN_EMAIL=your-email@example.com -- npx -y mcp-ipfs

Либо через JSON-конфиг:

claude mcp add-json alexbakers-mcp-ipfs-95wu8kol2j "{\"command\":\"npx\",\"args\":[\"-y\",\"mcp-ipfs\"],\"env\":{\"W3_LOGIN_EMAIL\":\"your-email@example.com\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add alexbakers-mcp-ipfs-95wu8kol2j --env W3_LOGIN_EMAIL=your-email@example.com -- npx -y mcp-ipfs

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.alexbakers-mcp-ipfs-95wu8kol2j]
command = "npx"
args = ["-y", "mcp-ipfs"]

[mcp_servers.alexbakers-mcp-ipfs-95wu8kol2j.env]
W3_LOGIN_EMAIL = "your-email@example.com"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите alexbakers/mcp-ipfs, а в поле команды запуска — строку ниже:
npx -y mcp-ipfs

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

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

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "alexbakers-mcp-ipfs-95wu8kol2j": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-ipfs"
      ],
      "env": {
        "W3_LOGIN_EMAIL": "your-email@example.com"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например alexbakers-mcp-ipfs-95wu8kol2j.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: alexbakers-mcp-ipfs-95wu8kol2j
    command: npx
    args:
      - "-y"
      - "mcp-ipfs"
    env:
      W3_LOGIN_EMAIL: your-email@example.com
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

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

Похожие MCP-сервера

ofershap/mcp-server-s3

ofershap/mcp-server-s3

от ofershap

MCP сервер для управления AWS S3 через ваш AI ассистент: просмотр и загрузка файлов, выгрузка контента, генерация временных ссылок (presigned URLs). Полезен разработчикам и DevOps, упрощает работу с облачным хранилищем, не требуя запоминать `aws s3` команды.

TypeScript⭐ 4
hmk/box-mcp-server

hmk/box-mcp-server

от hmk

MCP-сервер для поиска и чтения файлов в облачном хранилище Box. Поддерживает форматы PDF и Word, авторизуется через JWT или Developer Token. Помогает разработчикам подключать Box к AI-агентам.

JavaScript⭐ 11
bitatlas-group/bitatlas

bitatlas-group/bitatlas

от bitatlas-group

BitAtlas MCP сервер для защищённого облачного хранилища с E2E шифрованием и оплатой по запросу. Он позволяет AI-агентам безопасно искать, читать и управлять файлами без раскрытия данных. Идеально для приватной работы с документами.

MDX⭐ 1
SagaPeak/artifacta-mcp

SagaPeak/artifacta-mcp

от sagapeak

MCP сервер для Artifacta — хранилища артефактов для AI-агентов. Сохраняет файлы, отчеты и датасеты с метаданными сессии, передает между сессиями и делится по ссылкам с истечением. Дедупликация по х...

TypeScript⭐ 1
colapsis/transfa

colapsis/transfa

от colapsis

Transfa — это утилита и MCP-сервер для быстрого обмена файлами из терминала или через AI-агентов. Без регистрации загружайте файлы до 100 ГБ, получайте ссылку, защищайте паролем или устанавливайте ...

JavaScript⭐ 21
isaacphi/mcp-gdrive

isaacphi/mcp-gdrive

от isaacphi

Ищет и читает файлы в Google Drive, работает с Google Таблицами: обновляет ячейки и выгружает данные. Поддерживает документы, презентации и рисунки, конвертируя их в нужный формат.

TypeScript⭐ 282
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин