MCP server

Používejte IPFS Ninja přímo z AI asistentů pro programování jako Claude Code, Cursor a Windsurf. Nahrávejte soubory, připínejte CID, spravujte složky a kontrolujte využití — vše z vaší AI konverzace.

Co je MCP?

Model Context Protocol (MCP) je otevřený standard pro připojení AI asistentů k externím nástrojům a zdrojům dat. MCP server IPFS Ninja zpřístupňuje 11 nástrojů, které AI modely mohou volat během konverzací pro interakci s vaším účtem IPFS Ninja.

Instalace

Balíček npm

@ipfs-ninja/mcp-server

Dostupný na npm. Globální instalace není potřeba — spouští se přes npx.

Předpoklady

• Nainstalovaný Node.js 18+
• IPFS Ninja API klíč (získejte na Dashboard > API Keys)

Nastavení pro Claude Code

Krok 1: Získejte svůj API klíč

1. Zaregistrujte se na ipfs.ninja (zdarma)
2. Přejděte na Dashboard > API Keys
3. Klikněte na Create API key a zkopírujte celý klíč (zobrazí se pouze jednou)

Krok 2: Přidejte MCP server

Spusťte tento příkaz v terminálu:

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

Nebo přidejte ručně 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

Ukončete a znovu otevřete Claude Code. Napište /mcp pro ověření, že server IPFS Ninja je připojen.

Krok 4: Začněte používat

Jednoduše mluvte s Claude přirozeně:

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"

Nastavení pro Cursor / Windsurf

Přidejte do nastavení MCP (Settings > MCP Servers):

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

Dostupné nástroje

Operace se soubory

Nástroj	Popis	Příklad promptu
ipfs_upload	Nahrání obsahu souboru (base64 nebo text)	"Upload this HTML file to IPFS"
ipfs_upload_json	Nahrání JSON objektu	"Store this config as a permanent JSON on IPFS"
ipfs_list	Výpis nahraných souborů	"Show my recent uploads"
ipfs_get	Získání metadat souboru podle CID	"What type of file is QmXyz...?"
ipfs_delete	Odpojení a smazání souboru	"Delete QmXyz... from my account"

Připínání (Pinning)

Nástroj	Popis	Příklad promptu
ipfs_pin	Připnutí existujícího CID ze sítě	"Pin bafyabc... to my account"
ipfs_pin_status	Kontrola průběhu připínání	"Is bafyabc... done pinning?"

Organizace

Nástroj	Popis	Příklad promptu
ipfs_folders_list	Výpis vašich složek	"Show my folders"
ipfs_folders_create	Vytvoření nové složky	"Create a folder called nft-metadata"

Účet

Nástroj	Popis	Příklad promptu
ipfs_profile	Informace o plánu, úložišti a šířce pásma	"How much storage am I using?"
ipfs_analytics	Denní statistiky šířky pásma a souborů	"Show my bandwidth usage this week"

Příklady pracovních postupů

Nasazení statického webu

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 metadata

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

Sledování využití

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

Připnutí obsahu ze sítě

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

Řešení problémů

"IPFS_NINJA_API_KEY environment variable is required"

API klíč není nastaven. Ujistěte se, že sekce env ve vaší konfiguraci MCP obsahuje správný klíč.

"API error 402: not enough storage"

Dosáhli jste limitu úložiště vašeho plánu. Upgradujte na ipfs.ninja/pricing nebo smažte nepoužívané soubory.

"API error 403: Forbidden"

Váš API klíč může být neplatný nebo vypršel. Vytvořte nový na Dashboard > API Keys.

Server se nezobrazuje v /mcp

Ujistěte se, že jste restartovali Claude Code po přidání MCP serveru. Zkontrolujte, zda je nainstalovaný Node.js 18+ (node --version).