MCP szerver

Hasznald az IPFS Ninja-t kozvetlenul AI kodolasi asszisztensekbol, mint a Claude Code, Cursor es Windsurf. Tolts fel fajlokat, rogzits CID-eket, kezelj mappakat es ellenorizd a hasznalatodat — mindezt az AI beszelgetesedbol.

Mi az MCP?

A Model Context Protocol (MCP) egy nyilt szabvany AI asszisztensek kulso eszkozokhoz es adatforrasokhoz torteno csatlakozatasara. Az IPFS Ninja MCP szerver 11 eszkozt biztosit, amelyeket az AI modellek a beszelgetesek soran hivhatnak meg az IPFS Ninja fiokokkal valo interakciohoz.

Telepites

npm csomag

@ipfs-ninja/mcp-server

Elerheto az npm-en. Nincs szukseg globalis telepitesre — npx-en keresztul fut.

Elofeltetelok

Node.js 18+ telepitve
Egy IPFS Ninja API-kulcs (szerezz egyet a Vezerlopult > API-kulcsok oldalon)

Beallitas Claude Code-hoz

1. lepes: Szerezd meg az API-kulcsodat

Regisztralj az ipfs.ninja oldalon (ingyenes)
Menj a Vezerlopult > API-kulcsok oldalra
Kattints a Create API key gombra es masold ki a teljes kulcsot (csak egyszer jelenik meg)

2. lepes: Add hozza az MCP szervert

Futtasd ezt a parancsot a terminalodban:

bash

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

Vagy add hozza manualisam a .claude/settings.json fajlodhoz:

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. lepes: Inditsd ujra a Claude Code-ot

Lepj ki es nyisd ujra a Claude Code-ot. Ird be a /mcp parancsot, hogy ellenorizd, az IPFS Ninja szerver csatlakoztatva van-e.

4. lepes: Kezdd el hasznalni

Egyszeruen beszelj Claudenak termeszetesen:

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"

Beallitas Cursor / Windsurf szamara

Add hozza az MCP beallitasaidhoz (Settings > MCP Servers):

Beallitas	Ertek
Name	`ipfs-ninja`
Transport	`stdio`
Command	`npx`
Args	`-y @ipfs-ninja/mcp-server`
Environment	`IPFS_NINJA_API_KEY=bws_...`

Elerheto eszkozok

Fajlmuveletek

Eszkoz	Leiras	Pelda prompt
`ipfs_upload`	Fajltartalom feltoltese (base64 vagy szoveg)	"Toltsd fel ezt a HTML fajlt az IPFS-re"
`ipfs_upload_json`	JSON objektum feltoltese	"Tarold el ezt a konfigot allando JSON-kent az IPFS-en"
`ipfs_list`	Feltoltott fajljaid listazasa	"Mutasd a legutobbi feltolteseimet"
`ipfs_get`	Fajl metaadatok lekerese CID alapjan	"Milyen tipusu fajl a QmXyz...?"
`ipfs_delete`	Rogzites feloldasa es fajl torlese	"Torold a QmXyz...-t a fiokombol"

Rogzites

Eszkoz	Leiras	Pelda prompt
`ipfs_pin`	Meglevo CID rogzitese a halozatrol	"Rogzitsd a bafyabc...-t a fiokomra"
`ipfs_pin_status`	Rogzites allapotanak ellenorzese	"Kesz van a bafyabc... rogzitese?"

Szervezes

Eszkoz	Leiras	Pelda prompt
`ipfs_folders_list`	Mappaid listazasa	"Mutasd a mappaimat"
`ipfs_folders_create`	Uj mappa letrehozasa	"Hozz letre egy mappat nft-metadata neven"

Fiok

Eszkoz	Leiras	Pelda prompt
`ipfs_profile`	Csomag, tarolas es savszelesseg informaciok lekerese	"Mennyi tarolot hasznalok?"
`ipfs_analytics`	Napi savszelessegi es fajlstatisztikak lekerese	"Mutasd a savszelesseg-hasznalatomat ezen a heten"

Pelda munkafolyamatok

Statikus webhely koztetetelezese

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 metaadatok

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

Hasznalat figyelese

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

Tartalom rogzitese a halozatrol

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

Hibaelharitas

"IPFS_NINJA_API_KEY environment variable is required"

Az API-kulcs nincs beallitva. Gyozodj meg arrol, hogy az MCP konfiguraciod env szekcioja tartalmazza a helyes kulcsot.

"API error 402: not enough storage"

Elereted a csomagod tarolasi korlatjat. Frissits az ipfs.ninja/pricing oldalon, vagy torolj nem hasznalt fajlokat.

"API error 403: Forbidden"

Az API-kulcsod ervenytelen vagy lejarhatott. Hozz letre ujat a Vezerlopult > API-kulcsok oldalon.

A szerver nem jelenik meg a `/mcp` parancsnal

Gyozodj meg arrol, hogy ujrainditottad a Claude Code-ot az MCP szerver hozzaadasa utan. Ellenorizd, hogy a Node.js 18+ telepitve van (node --version).

MCP szerver ​

Mi az MCP? ​

Telepites ​

npm csomag ​

Elofeltetelok ​

Beallitas Claude Code-hoz ​

1. lepes: Szerezd meg az API-kulcsodat ​

2. lepes: Add hozza az MCP szervert ​

3. lepes: Inditsd ujra a Claude Code-ot ​

4. lepes: Kezdd el hasznalni ​

Beallitas Cursor / Windsurf szamara ​

Elerheto eszkozok ​

Fajlmuveletek ​

Rogzites ​

Szervezes ​

Fiok ​

Pelda munkafolyamatok ​

Statikus webhely koztetetelezese ​

NFT metaadatok ​

Hasznalat figyelese ​

Tartalom rogzitese a halozatrol ​

Hibaelharitas ​

"IPFS_NINJA_API_KEY environment variable is required" ​

"API error 402: not enough storage" ​

"API error 403: Forbidden" ​

A szerver nem jelenik meg a /mcp parancsnal ​