MCP-server

Bruk IPFS Ninja direkte fra AI-kodeassistenter som Claude Code, Cursor og Windsurf. Last opp filer, pinn CID-er, administrer mapper og sjekk bruk — alt fra AI-samtalen din.

Hva er MCP?

Model Context Protocol (MCP) er en åpen standard for å koble AI-assistenter til eksterne verktøy og datakilder. IPFS Ninja MCP-serveren eksponerer 11 verktøy som AI-modeller kan kalle under samtaler for å samhandle med IPFS Ninja-kontoen din.

Installasjon

npm-pakke

@ipfs-ninja/mcp-server

Tilgjengelig på npm. Ingen global installasjon nødvendig — kjøres via npx.

Forutsetninger

• Node.js 18+ installert
• En IPFS Ninja API-nøkkel (hent en på Dashboard > API Keys)

Oppsett for Claude Code

Steg 1: Hent API-nøkkelen din

1. Registrer deg på ipfs.ninja (gratis)
2. Gå til Dashboard > API Keys
3. Klikk Create API key og kopier den fullstendige nøkkelen (vises bare én gang)

Steg 2: Legg til MCP-serveren

Kjør denne kommandoen i terminalen din:

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

Eller legg til manuelt i .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"
      }
    }
  }
}

Steg 3: Start Claude Code på nytt

Avslutt og åpne Claude Code igjen. Skriv /mcp for å bekrefte at IPFS Ninja-serveren er tilkoblet.

Steg 4: Begynn å bruke det

Snakk med Claude naturlig:

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"

Oppsett for Cursor / Windsurf

Legg til i MCP-innstillingene dine (Settings > MCP Servers):

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

Tilgjengelige verktøy

Filoperasjoner

Verktøy	Beskrivelse	Eksempel på forespørsel
ipfs_upload	Last opp filinnhold (base64 eller tekst)	"Upload this HTML file to IPFS"
ipfs_upload_json	Last opp et JSON-objekt	"Store this config as a permanent JSON on IPFS"
ipfs_list	List opplastede filer	"Show my recent uploads"
ipfs_get	Hent filmetadata etter CID	"What type of file is QmXyz...?"
ipfs_delete	Avpinn og slett en fil	"Delete QmXyz... from my account"

Pinning

Verktøy	Beskrivelse	Eksempel på forespørsel
ipfs_pin	Pinn en eksisterende CID fra nettverket	"Pin bafyabc... to my account"
ipfs_pin_status	Sjekk pinnefremdrift	"Is bafyabc... done pinning?"

Organisering

Verktøy	Beskrivelse	Eksempel på forespørsel
ipfs_folders_list	List mappene dine	"Show my folders"
ipfs_folders_create	Opprett en ny mappe	"Create a folder called nft-metadata"

Konto

Verktøy	Beskrivelse	Eksempel på forespørsel
ipfs_profile	Hent plan-, lagrings- og båndbreddeinformasjon	"How much storage am I using?"
ipfs_analytics	Hent daglig båndbredde- og filstatistikk	"Show my bandwidth usage this week"

Eksempler på arbeidsflyter

Distribuere en statisk nettside

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

Overvåke bruk

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

Pinne innhold fra nettverket

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

Feilsøking

"IPFS_NINJA_API_KEY environment variable is required"

API-nøkkelen er ikke satt. Sørg for at env-seksjonen i MCP-konfigurasjonen din har riktig nøkkel.

"API error 402: not enough storage"

Du har nådd planens lagringsgrense. Oppgrader på ipfs.ninja/pricing eller slett ubrukte filer.

"API error 403: Forbidden"

API-nøkkelen din kan være ugyldig eller utløpt. Opprett en ny på Dashboard > API Keys.

Serveren vises ikke i /mcp

Sørg for at du startet Claude Code på nytt etter at du la til MCP-serveren. Sjekk at Node.js 18+ er installert (node --version).