MCP Сервер

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

Що таке 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... з мого облікового запису"

Закріплення

Інструмент	Опис	Приклад запиту
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" та завантаж цей metadata JSON
Claude: [викликає ipfs_folders_create, потім ipfs_upload_json]
     → Папка: my-collection
     → CID: QmAbc... — постійна URL метаданих, готова для вашого смарт-контракту

Моніторинг використання

Ви: Я близько до ліміту сховища?
Claude: [викликає ipfs_profile]
     → План: Bodhi, Сховище: 45.2 MB / 100 GB (0.04%)
     → У вас достатньо місця.

Ви: Покажи мій трафік за цей тиждень
Claude: [викликає ipfs_analytics з days=7]
     → 2.3 MB трафіку, 45 запитів за 3 дні

Закріплення вмісту з мережі

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

Ви: Воно завершилось?
Claude: [викликає ipfs_pin_status]
     → Статус: закріплено, Розмір: 0.008 MB

Усунення неполадок

"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).