MCP strežnik

Uporabite IPFS Ninja neposredno iz AI pomočnikov za kodiranje, kot so Claude Code, Cursor in Windsurf. Nalagajte datoteke, pripenjajte CID-je, upravljajte mape in preverjajte porabo -- vse iz vašega pogovora z AI.

Kaj je MCP?

Model Context Protocol (MCP) je odprti standard za povezovanje AI pomočnikov z zunanjimi orodji in viri podatkov. MCP strežnik IPFS Ninja ponuja 11 orodij, ki jih AI modeli lahko kličejo med pogovori za interakcijo z vašim računom IPFS Ninja.

Namestitev

npm paket

@ipfs-ninja/mcp-server

Na voljo na npm. Globalna namestitev ni potrebna -- zažene se prek npx.

Predpogoji

• Nameščen Node.js 18+
• API ključ IPFS Ninja (pridobite ga na Nadzorna plošča > API ključi)

Nastavitev za Claude Code

1. korak: Pridobite API ključ

1. Registrirajte se na ipfs.ninja (brezplačno)
2. Pojdite na Nadzorna plošča > API ključi
3. Kliknite Create API key in kopirajte celoten ključ (prikazan je samo enkrat)

2. korak: Dodajte MCP strežnik

V terminalu zaženite ta ukaz:

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

Ali ročno dodajte v vašo datoteko .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. korak: Znova zaženite Claude Code

Zaprite in znova odprite Claude Code. Vpišite /mcp, da preverite, ali je strežnik IPFS Ninja povezan.

4. korak: Začnite uporabljati

Preprosto se pogovarjajte s Claude naravno:

Vi: Naloži moj README.md na IPFS
Vi: Pokaži moje zadnje datoteke
Vi: Koliko prostora uporabljam?
Vi: Pripni bafyabc123... z omrežja IPFS
Vi: Ustvari mapo z imenom "project-assets"

Nastavitev za Cursor / Windsurf

Dodajte v vaše MCP nastavitve (Settings > MCP Servers):

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

Razpoložljiva orodja

Operacije z datotekami

Orodje	Opis	Primer ukaza
ipfs_upload	Naloži vsebino datoteke (base64 ali besedilo)	"Naloži to HTML datoteko na IPFS"
ipfs_upload_json	Naloži JSON objekt	"Shrani to konfiguracijo kot trajen JSON na IPFS"
ipfs_list	Izpiši vaše naložene datoteke	"Pokaži moje zadnje naložene datoteke"
ipfs_get	Pridobi metapodatke datoteke po CID	"Kakšna vrsta datoteke je QmXyz...?"
ipfs_delete	Odpni in izbriši datoteko	"Izbriši QmXyz... iz mojega računa"

Pripenjanje

Orodje	Opis	Primer ukaza
ipfs_pin	Pripni obstoječi CID z omrežja	"Pripni bafyabc... na moj račun"
ipfs_pin_status	Preveri stanje pripenjanja	"Ali je bafyabc... že pripet?"

Organizacija

Orodje	Opis	Primer ukaza
ipfs_folders_list	Izpiši vaše mape	"Pokaži moje mape"
ipfs_folders_create	Ustvari novo mapo	"Ustvari mapo z imenom nft-metadata"

Račun

Orodje	Opis	Primer ukaza
ipfs_profile	Pridobi podatke o načrtu, prostoru in pasovni širini	"Koliko prostora uporabljam?"
ipfs_analytics	Pridobi dnevno statistiko pasovne širine in datotek	"Pokaži mojo porabo pasovne širine ta teden"

Primeri delovnih tokov

Objava statične spletne strani

Vi: Naloži vsebino moje mape dist/ na IPFS
Claude: [naloži vsako datoteko, vrne CID-je]

Vi: Kateri je CID za index.html?
Claude: [pokliče ipfs_get]
     → QmXyz... — https://ipfs.ninja/ipfs/QmXyz...

NFT metapodatki

Vi: Ustvari mapo z imenom "my-collection" in naloži te metapodatke v JSON
Claude: [pokliče ipfs_folders_create, nato ipfs_upload_json]
     → Mapa: my-collection
     → CID: QmAbc... — trajni URL metapodatkov, pripravljen za vašo pametno pogodbo

Spremljanje porabe

Vi: Ali sem blizu omejitve prostora?
Claude: [pokliče ipfs_profile]
     → Načrt: Bodhi, Prostor: 45.2 MB / 100 GB (0.04%)
     → Imate še veliko prostora.

Vi: Pokaži mojo pasovno širino ta teden
Claude: [pokliče ipfs_analytics z days=7]
     → 2.3 MB pasovne širine, 45 zahtev v 3 dneh

Pripenjanje vsebine z omrežja

Vi: Pripni IPFS readme na QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG
Claude: [pokliče ipfs_pin]
     → Pripenjanje sproženo! Stanje: pripenjanje

Vi: Ali je končano?
Claude: [pokliče ipfs_pin_status]
     → Stanje: pripeto, Velikost: 0.008 MB

Odpravljanje težav

"IPFS_NINJA_API_KEY environment variable is required"

API ključ ni nastavljen. Preverite, da ima sekcija env v vaši MCP konfiguraciji pravilen ključ.

"API error 402: not enough storage"

Dosegli ste omejitev prostora vašega načrta. Nadgradite na ipfs.ninja/pricing ali izbrišite neuporabljene datoteke.

"API error 403: Forbidden"

Vaš API ključ je morda neveljaven ali potekel. Ustvarite novega na Nadzorna plošča > API ključi.

Strežnik se ne prikaže v /mcp

Preverite, da ste po dodajanju MCP strežnika znova zagnali Claude Code. Preverite, da je nameščen Node.js 18+ (node --version).