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+
• IPFS Ninja API ключ (вземете такъв от 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 естествено:

You: Upload my README.md to IPFS
You: List my recent files
You: How much storage am I using?
You: Pin bafyabc123... from the IPFS network
You: Create a folder called "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 или текст)	"Upload this HTML file to IPFS"
ipfs_upload_json	Качване на JSON обект	"Store this config as a permanent JSON on IPFS"
ipfs_list	Списък на качените файлове	"Show my recent uploads"
ipfs_get	Получаване на метаданни за файл по CID	"What type of file is QmXyz...?"
ipfs_delete	Премахване на пинването и изтриване на файл	"Delete QmXyz... from my account"

Пинване

Инструмент	Описание	Примерна заявка
ipfs_pin	Пинване на съществуващ CID от мрежата	"Pin bafyabc... to my account"
ipfs_pin_status	Проверка на напредъка на пинването	"Is bafyabc... done pinning?"

Организация

Инструмент	Описание	Примерна заявка
ipfs_folders_list	Списък на вашите папки	"Show my folders"
ipfs_folders_create	Създаване на нова папка	"Create a folder called nft-metadata"

Акаунт

Инструмент	Описание	Примерна заявка
ipfs_profile	Информация за план, съхранение и трафик	"How much storage am I using?"
ipfs_analytics	Дневна статистика за трафик и файлове	"Show my bandwidth usage this week"

Примерни работни процеси

Публикуване на статичен сайт

You: Upload the contents of my dist/ folder to IPFS
Claude: [uploads each file, returns CIDs]

You: What's the CID for index.html?
Claude: [calls ipfs_get]
     → QmXyz... — https://ipfs.ninja/ipfs/QmXyz...

NFT метаданни

You: Create a folder called "my-collection" and upload this metadata JSON
Claude: [calls ipfs_folders_create, then ipfs_upload_json]
     → Folder: my-collection
     → CID: QmAbc... — permanent metadata URL ready for your smart contract

Наблюдение на използването

You: Am I close to my storage limit?
Claude: [calls ipfs_profile]
     → Plan: Bodhi, Storage: 45.2 MB / 100 GB (0.04%)
     → You have plenty of room.

You: Show my bandwidth this week
Claude: [calls ipfs_analytics with days=7]
     → 2.3 MB bandwidth, 45 requests across 3 days

Пинване на съдържание от мрежата

You: Pin the IPFS readme at QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG
Claude: [calls ipfs_pin]
     → Pin initiated! Status: pinning

You: Is it done?
Claude: [calls ipfs_pin_status]
     → Status: pinned, Size: 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).