Сервер MCP

Используйте IPFS Ninja прямо из AI-помощников для программирования, таких как Claude Code, Cursor и Windsurf. Загружайте файлы, закрепляйте CID, управляйте папками и проверяйте использование — всё из вашего разговора с ИИ.

Что такое MCP?

Model Context Protocol (MCP) — это открытый стандарт для подключения AI-помощников к внешним инструментам и источникам данных. MCP-сервер IPFS Ninja предоставляет 11 инструментов, которые AI-модели могут вызывать во время разговоров для взаимодействия с вашим аккаунтом IPFS Ninja.

Установка

Пакет npm

@ipfs-ninja/mcp-server

Доступен на npm. Глобальная установка не требуется — запускается через npx.

Предварительные требования

• Установлен Node.js 18+
• API-ключ IPFS Ninja (получите на Dashboard > API Keys)

Настройка для Claude Code

Шаг 1: Получите API-ключ

1. Зарегистрируйтесь на ipfs.ninja (бесплатно)
2. Перейдите в Dashboard > API Keys
3. Нажмите Create API key и скопируйте полный ключ (показывается только один раз)

Шаг 2: Добавьте MCP-сервер

Выполните эту команду в терминале:

claude mcp add ipfs-ninja \
  --transport stdio \
  -e IPFS_NINJA_API_KEY=bws_your_full_api_key_here \
  -- npx -y @ipfs-ninja/mcp-server

Или добавьте вручную в .claude/settings.json:

{
  "mcpServers": {
    "ipfs-ninja": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@ipfs-ninja/mcp-server"],
      "env": {
        "IPFS_NINJA_API_KEY": "bws_your_full_api_key_here"
      }
    }
  }
}

Шаг 3: Перезапустите Claude Code

Закройте и снова откройте Claude Code. Введите /mcp, чтобы убедиться, что сервер IPFS Ninja подключён.

Шаг 4: Начните использовать

Просто общайтесь с Claude естественным образом:

Вы: Загрузи мой README.md в IPFS
Вы: Покажи мои последние файлы
Вы: Сколько хранилища я использую?
Вы: Закрепи bafyabc123... из сети IPFS
Вы: Создай папку "project-assets"

Настройка для Cursor / Windsurf

Добавьте в настройки MCP (Settings > MCP Servers):

Параметр	Значение
Name	ipfs-ninja
Transport	stdio
Command	npx
Args	-y @ipfs-ninja/mcp-server
Environment	IPFS_NINJA_API_KEY=bws_...

Доступные инструменты

Операции с файлами

Инструмент	Описание	Пример промпта
ipfs_upload	Загружает содержимое файла (base64 или текст)	"Загрузи этот HTML-файл в IPFS"
ipfs_upload_json	Загружает JSON-объект	"Сохрани этот конфиг как постоянный JSON в IPFS"
ipfs_list	Показывает ваши загруженные файлы	"Покажи мои последние загрузки"
ipfs_get	Получает метаданные файла по CID	"Что за файл QmXyz...?"
ipfs_delete	Открепляет и удаляет файл	"Удали QmXyz... из моего аккаунта"

Закрепление (Pinning)

Инструмент	Описание	Пример промпта
ipfs_pin	Закрепляет существующий CID из сети	"Закрепи bafyabc... в моём аккаунте"
ipfs_pin_status	Проверяет прогресс закрепления	"bafyabc... уже закреплён?"

Организация

Инструмент	Описание	Пример промпта
ipfs_folders_list	Показывает ваши папки	"Покажи мои папки"
ipfs_folders_create	Создаёт новую папку	"Создай папку nft-metadata"

Аккаунт

Инструмент	Описание	Пример промпта
ipfs_profile	Показывает план, хранилище и пропускную способность	"Сколько хранилища я использую?"
ipfs_analytics	Показывает ежедневную статистику по трафику и файлам	"Покажи использование трафика за эту неделю"

Примеры рабочих процессов

Развёртывание статического сайта

Вы: Загрузи содержимое моей папки dist/ в IPFS
Claude: [загружает каждый файл, возвращает CID]

Вы: Какой CID у index.html?
Claude: [вызывает ipfs_get]
     → QmXyz... — https://ipfs.ninja/ipfs/QmXyz...

Метаданные NFT

Вы: Создай папку "my-collection" и загрузи этот JSON с метаданными
Claude: [вызывает ipfs_folders_create, затем ipfs_upload_json]
     → Папка: my-collection
     → CID: QmAbc... — постоянный URL метаданных, готовый для вашего смарт-контракта

Мониторинг использования

Вы: Я близок к лимиту хранилища?
Claude: [вызывает ipfs_profile]
     → План: Bodhi, Хранилище: 45.2 МБ / 100 ГБ (0.04%)
     → У вас достаточно места.

Вы: Покажи мой трафик за эту неделю
Claude: [вызывает ipfs_analytics с days=7]
     → 2.3 МБ трафика, 45 запросов за 3 дня

Закрепление контента из сети

Вы: Закрепи readme IPFS по адресу QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG
Claude: [вызывает ipfs_pin]
     → Закрепление запущено! Статус: закрепляется

Вы: Уже готово?
Claude: [вызывает ipfs_pin_status]
     → Статус: закреплён, Размер: 0.008 МБ

Устранение неполадок

"IPFS_NINJA_API_KEY environment variable is required"

API-ключ не задан. Убедитесь, что в разделе env вашей конфигурации MCP указан правильный ключ.

"API error 402: not enough storage"

Вы достигли лимита хранилища вашего плана. Обновите план на ipfs.ninja/pricing или удалите неиспользуемые файлы.

"API error 403: Forbidden"

Ваш API-ключ может быть недействительным или истёкшим. Создайте новый на Dashboard > API Keys.

Сервер не отображается в /mcp

Убедитесь, что вы перезапустили Claude Code после добавления MCP-сервера. Проверьте, что установлен Node.js 18+ (node --version).