MCP server

Koristite IPFS Ninja direktno iz AI asistenata za kodiranje kao što su Claude Code, Cursor i Windsurf. Otpremajte datoteke, pinujte CID-ove, upravljajte folderima i proveravajte potrošnju -- sve iz vašeg razgovora sa AI.

Šta je MCP?

Model Context Protocol (MCP) je otvoreni standard za povezivanje AI asistenata sa spoljnim alatima i izvorima podataka. MCP server IPFS Ninja nudi 11 alata koje AI modeli mogu pozivati tokom razgovora za interakciju sa vašim IPFS Ninja nalogom.

Instalacija

npm paket

@ipfs-ninja/mcp-server

Dostupan na npm. Nije potrebna globalna instalacija -- pokreće se preko npx.

Preduslovi

• Instaliran Node.js 18+
• IPFS Ninja API ključ (nabavite ga na Kontrolna tabla > API ključevi)

Podešavanje za Claude Code

Korak 1: Nabavite API ključ

1. Registrujte se na ipfs.ninja (besplatno)
2. Idite na Kontrolna tabla > API ključevi
3. Kliknite Create API key i kopirajte ceo ključ (prikazuje se samo jednom)

Korak 2: Dodajte MCP server

Pokrenite ovu komandu u terminalu:

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

Ili ručno dodajte u vašu datoteku .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"
      }
    }
  }
}

Korak 3: Restartujte Claude Code

Zatvorite i ponovo otvorite Claude Code. Ukucajte /mcp da proverite da li je IPFS Ninja server povezan.

Korak 4: Počnite da koristite

Jednostavno razgovarajte sa Claude prirodno:

Vi: Otpremi moj README.md na IPFS
Vi: Prikaži moje nedavne datoteke
Vi: Koliko prostora za skladištenje koristim?
Vi: Pinuj bafyabc123... sa IPFS mreže
Vi: Kreiraj folder pod imenom "project-assets"

Podešavanje za Cursor / Windsurf

Dodajte u vaša MCP podešavanja (Settings > MCP Servers):

Podešavanje	Vrednost
Name	ipfs-ninja
Transport	stdio
Command	npx
Args	-y @ipfs-ninja/mcp-server
Environment	IPFS_NINJA_API_KEY=bws_...

Dostupni alati

Operacije sa datotekama

Alat	Opis	Primer upita
ipfs_upload	Otpremi sadržaj datoteke (base64 ili tekst)	"Otpremi ovu HTML datoteku na IPFS"
ipfs_upload_json	Otpremi JSON objekat	"Sačuvaj ovu konfiguraciju kao trajni JSON na IPFS"
ipfs_list	Izlistaj vaše otpremljene datoteke	"Prikaži moja nedavna otpremanja"
ipfs_get	Dobij metapodatke datoteke po CID	"Koji tip datoteke je QmXyz...?"
ipfs_delete	Odpinuj i obriši datoteku	"Obriši QmXyz... sa mog naloga"

Pinovanje

Alat	Opis	Primer upita
ipfs_pin	Pinuj postojeći CID sa mreže	"Pinuj bafyabc... na moj nalog"
ipfs_pin_status	Proveri status pinovanja	"Da li je bafyabc... završeno sa pinovanjem?"

Organizacija

Alat	Opis	Primer upita
ipfs_folders_list	Izlistaj vaše foldere	"Prikaži moje foldere"
ipfs_folders_create	Kreiraj novi folder	"Kreiraj folder pod imenom nft-metadata"

Nalog

Alat	Opis	Primer upita
ipfs_profile	Dobij info o planu, prostoru i propusnom opsegu	"Koliko prostora za skladištenje koristim?"
ipfs_analytics	Dobij dnevnu statistiku propusnog opsega i datoteka	"Prikaži moju potrošnju propusnog opsega ove nedelje"

Primeri radnih tokova

Objava statičkog sajta

Vi: Otpremi sadržaj mog dist/ foldera na IPFS
Claude: [otprema svaku datoteku, vraća CID-ove]

Vi: Koji je CID za index.html?
Claude: [poziva ipfs_get]
     → QmXyz... — https://ipfs.ninja/ipfs/QmXyz...

NFT metapodaci

Vi: Kreiraj folder pod imenom "my-collection" i otpremi ove metapodatke u JSON
Claude: [poziva ipfs_folders_create, zatim ipfs_upload_json]
     → Folder: my-collection
     → CID: QmAbc... — trajni URL metapodataka spreman za vaš pametni ugovor

Praćenje potrošnje

Vi: Da li sam blizu ograničenja prostora?
Claude: [poziva ipfs_profile]
     → Plan: Bodhi, Prostor: 45.2 MB / 100 GB (0.04%)
     → Imate dovoljno prostora.

Vi: Prikaži moj propusni opseg ove nedelje
Claude: [poziva ipfs_analytics sa days=7]
     → 2.3 MB propusnog opsega, 45 zahteva u 3 dana

Pinovanje sadržaja sa mreže

Vi: Pinuj IPFS readme na QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG
Claude: [poziva ipfs_pin]
     → Pinovanje pokrenuto! Status: pinovanje

Vi: Da li je završeno?
Claude: [poziva ipfs_pin_status]
     → Status: pinovano, Veličina: 0.008 MB

Rešavanje problema

"IPFS_NINJA_API_KEY environment variable is required"

API ključ nije podešen. Proverite da sekcija env u vašoj MCP konfiguraciji ima ispravan ključ.

"API error 402: not enough storage"

Dostigli ste ograničenje prostora vašeg plana. Nadogradite na ipfs.ninja/pricing ili obrišite nekorišćene datoteke.

"API error 403: Forbidden"

Vaš API ključ je možda nevažeći ili istekao. Kreirajte novi na Kontrolna tabla > API ključevi.

Server se ne prikazuje u /mcp

Proverite da ste restartovali Claude Code nakon dodavanja MCP servera. Proverite da je instaliran Node.js 18+ (node --version).