MCP posluzitelj

Koristite IPFS Ninja izravno iz AI asistenata za kodiranje poput Claude Code, Cursor i Windsurf. Prenosite datoteke, prikacite CID-ove, upravljajte mapama i provjeravajte potrosnju — sve iz svog AI razgovora.

Sto je MCP?

Model Context Protocol (MCP) je otvoreni standard za povezivanje AI asistenata s vanjskim alatima i izvorima podataka. IPFS Ninja MCP posluzitelj pruza 11 alata koje AI modeli mogu pozivati tijekom razgovora za interakciju s vasim IPFS Ninja racunom.

Instalacija

npm paket

@ipfs-ninja/mcp-server

Dostupan na npm. Nije potrebna globalna instalacija — pokrece se putem npx.

Preduvjeti

• Node.js 18+ instaliran
• IPFS Ninja API kljuc (nabavite na Nadzorna ploca > API kljucevi)

Postavljanje za Claude Code

Korak 1: Nabavite svoj API kljuc

1. Registrirajte se na ipfs.ninja (besplatno)
2. Idite na Nadzorna ploca > API kljucevi
3. Kliknite Create API key i kopirajte cijeli kljuc (prikazuje se samo jednom)

Korak 2: Dodajte MCP posluzitelj

Pokrenite ovu naredbu u svom 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 rucno dodajte u svoju .claude/settings.json datoteku:

{
  "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: Ponovno pokrenite Claude Code

Zatvorite i ponovno otvorite Claude Code. Upisite /mcp da biste potvrdili da je IPFS Ninja posluzitelj povezan.

Korak 4: Pocnite koristiti

Jednostavno razgovarajte s Claudeom prirodno:

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"

Postavljanje za Cursor / Windsurf

Dodajte u svoje MCP postavke (Settings > MCP Servers):

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

Dostupni alati

Operacije s datotekama

Alat	Opis	Primjer prompta
ipfs_upload	Prenesite sadrzaj datoteke (base64 ili tekst)	"Prenesi ovu HTML datoteku na IPFS"
ipfs_upload_json	Prenesite JSON objekt	"Spremi ovu konfiguraciju kao trajni JSON na IPFS"
ipfs_list	Listajte prenesene datoteke	"Pokazi moje nedavne prijenose"
ipfs_get	Dohvatite metapodatke datoteke prema CID-u	"Koja je vrsta datoteke QmXyz...?"
ipfs_delete	Otkacite i obrisite datoteku	"Obrisi QmXyz... s mog racuna"

Prikacivanje

Alat	Opis	Primjer prompta
ipfs_pin	Prikacite postojeci CID s mreze	"Prikaci bafyabc... na moj racun"
ipfs_pin_status	Provjerite napredak prikacivanja	"Je li bafyabc... zavrsio s prikacivanjem?"

Organizacija

Alat	Opis	Primjer prompta
ipfs_folders_list	Listajte svoje mape	"Pokazi moje mape"
ipfs_folders_create	Stvorite novu mapu	"Stvori mapu pod nazivom nft-metadata"

Racun

Alat	Opis	Primjer prompta
ipfs_profile	Dohvatite informacije o planu, pohrani i propusnosti	"Koliko pohrane koristim?"
ipfs_analytics	Dohvatite dnevne statistike propusnosti i datoteka	"Pokazi moju potrosnju propusnosti ovog tjedna"

Primjeri radnih tokova

Objava staticke stranice

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 metapodaci

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

Pracenje potrosnje

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

Prikacivanje sadrzaja s mreze

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

Rjesavanje problema

"IPFS_NINJA_API_KEY environment variable is required"

API kljuc nije postavljen. Provjerite da sekcija env u vasoj MCP konfiguraciji sadrzi ispravni kljuc.

"API error 402: not enough storage"

Dosegli ste ogranicenje pohrane svog plana. Nadogradite na ipfs.ninja/pricing ili obrisite nekoristene datoteke.

"API error 403: Forbidden"

Vas API kljuc moze biti nevazeci ili istekao. Stvorite novi na Nadzorna ploca > API kljucevi.

Posluzitelj se ne prikazuje u /mcp

Provjerite jeste li ponovno pokrenuli Claude Code nakon dodavanja MCP posluzitelja. Provjerite je li Node.js 18+ instaliran (node --version).