MCP Server

Pouzivajte IPFS Ninja priamo z AI asistentov pre programovanie ako Claude Code, Cursor a Windsurf. Nahravajte subory, pripinajte CID, spravujte priecinky a kontrolujte vyuzitie — vsetko z vasho rozhovoru s AI.

Co je MCP?

Model Context Protocol (MCP) je otvoreny standard na prepojenie AI asistentov s externymi nastrojmi a zdrojmi dat. MCP server IPFS Ninja poskytuje 11 nastrojov, ktore AI modely mozu volat pocas konverzacii na interakciu s vasim uctom IPFS Ninja.

Instalacia

Balik npm

@ipfs-ninja/mcp-server

Dostupny na npm. Nevyzaduje globalnu instalaciu — spusta sa cez npx.

Predpoklady

• Nainstalovany Node.js 18+
• API kluc IPFS Ninja (ziskajte na Dashboard > API Keys)

Nastavenie pre Claude Code

Krok 1: Ziskajte API kluc

1. Zaregistrujte sa na ipfs.ninja (zadarmo)
2. Prejdite na Dashboard > API Keys
3. Kliknite na Create API key a skopirujte cely kluc (zobrazi sa iba raz)

Krok 2: Pridajte MCP server

Spustite tento prikaz v terminali:

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

Alebo pridajte manualne do .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"
      }
    }
  }
}

Krok 3: Restartujte Claude Code

Zatvorte a znovu otvorte Claude Code. Zadajte /mcp na overenie, ze server IPFS Ninja je pripojeny.

Krok 4: Zacnite pouzivat

Jednoducho sa rozpravajte s Claude prirodzene:

Vy: Nahraj moj README.md na IPFS
Vy: Vypis moje posledne subory
Vy: Kolko uloziska pouzivam?
Vy: Pripni bafyabc123... zo siete IPFS
Vy: Vytvor priecinok s nazvom "project-assets"

Nastavenie pre Cursor / Windsurf

Pridajte do nastaveni MCP (Settings > MCP Servers):

Nastavenie	Hodnota
Name	ipfs-ninja
Transport	stdio
Command	npx
Args	-y @ipfs-ninja/mcp-server
Environment	IPFS_NINJA_API_KEY=bws_...

Dostupne nastroje

Operacie so subormi

Nastroj	Popis	Priklad promptu
ipfs_upload	Nahra obsah suboru (base64 alebo text)	"Nahraj tento HTML subor na IPFS"
ipfs_upload_json	Nahra JSON objekt	"Uloz tento config ako trvaly JSON na IPFS"
ipfs_list	Vypise vase nahrane subory	"Ukaz moje posledne nahravania"
ipfs_get	Ziska metadata suboru podla CID	"Aky typ suboru je QmXyz...?"
ipfs_delete	Odpripne a vymaze subor	"Vymazni QmXyz... z mojho uctu"

Pripinanie (Pinning)

Nastroj	Popis	Priklad promptu
ipfs_pin	Pripne existujuci CID zo siete	"Pripni bafyabc... do mojho uctu"
ipfs_pin_status	Overi priebeh pripinavania	"Uz je bafyabc... pripnuty?"

Organizacia

Nastroj	Popis	Priklad promptu
ipfs_folders_list	Vypise vase priecinky	"Ukaz moje priecinky"
ipfs_folders_create	Vytvori novy priecinok	"Vytvor priecinok s nazvom nft-metadata"

Ucet

Nastroj	Popis	Priklad promptu
ipfs_profile	Ziska informacie o plane, ulozisku a sirke pasma	"Kolko uloziska pouzivam?"
ipfs_analytics	Ziska denne statistiky sirky pasma a suborov	"Ukaz moje vyuzitie sirky pasma tento tyzden"

Priklady pracovnych postupov

Nasadenie statickej stranky

Vy: Nahraj obsah mojho priecinka dist/ na IPFS
Claude: [nahra kazdy subor, vrati CID]

Vy: Aky je CID pre index.html?
Claude: [zavola ipfs_get]
     → QmXyz... — https://ipfs.ninja/ipfs/QmXyz...

NFT metadata

Vy: Vytvor priecinok s nazvom "my-collection" a nahraj tento JSON s metadatami
Claude: [zavola ipfs_folders_create, potom ipfs_upload_json]
     → Priecinok: my-collection
     → CID: QmAbc... — trvala URL metadat pripravena pre vas smart contract

Monitorovanie vyuzitia

Vy: Som blizko limitu uloziska?
Claude: [zavola ipfs_profile]
     → Plan: Bodhi, Ulozisko: 45.2 MB / 100 GB (0.04%)
     → Mate dostatok miesta.

Vy: Ukaz moju sirku pasma tento tyzden
Claude: [zavola ipfs_analytics s days=7]
     → 2.3 MB sirky pasma, 45 poziadaviek za 3 dni

Pripnutie obsahu zo siete

Vy: Pripni IPFS readme na QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG
Claude: [zavola ipfs_pin]
     → Pripinanie spustene! Stav: pripina sa

Vy: Uz je to hotove?
Claude: [zavola ipfs_pin_status]
     → Stav: pripnuty, Velkost: 0.008 MB

Riesenie problemov

"IPFS_NINJA_API_KEY environment variable is required"

API kluc nie je nastaveny. Uistite sa, ze sekcia env vo vasej konfiguraci MCP obsahuje spravny kluc.

"API error 402: not enough storage"

Dosiahli ste limit uloziska vasho planu. Inovujte na ipfs.ninja/pricing alebo vymazte nepouzivane subory.

"API error 403: Forbidden"

Vas API kluc mozno nie je platny alebo vyprsal. Vytvorte novy na Dashboard > API Keys.

Server sa nezobrazuje v /mcp

Uistite sa, ze ste restartovali Claude Code po pridani MCP servera. Overte, ze je nainstalovany Node.js 18+ (node --version).