MCP-server

Använd IPFS Ninja direkt från AI-kodningsassistenter som Claude Code, Cursor och Windsurf. Ladda upp filer, pinna CID:er, hantera mappar och kontrollera användning -- allt från din AI-konversation.

Vad är MCP?

Model Context Protocol (MCP) är en öppen standard för att koppla AI-assistenter till externa verktyg och datakällor. IPFS Ninja MCP-servern exponerar 11 verktyg som AI-modeller kan anropa under konversationer för att interagera med ditt IPFS Ninja-konto.

Installation

npm-paket

@ipfs-ninja/mcp-server

Tillgängligt på npm. Ingen global installation behövs -- körs via npx.

Förutsättningar

• Node.js 18+ installerat
• En IPFS Ninja API-nyckel (skaffa en på Instrumentpanel > API-nycklar)

Inställning för Claude Code

Steg 1: Skaffa din API-nyckel

1. Registrera dig på ipfs.ninja (gratis)
2. Gå till Instrumentpanel > API-nycklar
3. Klicka på Create API key och kopiera hela nyckeln (visas bara en gång)

Steg 2: Lägg till MCP-servern

Kör detta kommando i din terminal:

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 lägg till manuellt i din .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: Starta om Claude Code

Stäng och öppna Claude Code igen. Skriv /mcp för att verifiera att IPFS Ninja-servern är ansluten.

Steg 4: Börja använda

Prata helt enkelt med Claude naturligt:

Du: Ladda upp min README.md till IPFS
Du: Visa mina senaste filer
Du: Hur mycket lagring använder jag?
Du: Pinna bafyabc123... från IPFS-nätverket
Du: Skapa en mapp som heter "project-assets"

Inställning för Cursor / Windsurf

Lägg till i dina MCP-inställningar (Settings > MCP Servers):

Inställning	Värde
Name	ipfs-ninja
Transport	stdio
Command	npx
Args	-y @ipfs-ninja/mcp-server
Environment	IPFS_NINJA_API_KEY=bws_...

Tillgängliga verktyg

Filoperationer

Verktyg	Beskrivning	Exempelfråga
ipfs_upload	Ladda upp filinnehåll (base64 eller text)	"Ladda upp denna HTML-fil till IPFS"
ipfs_upload_json	Ladda upp ett JSON-objekt	"Spara denna konfiguration som permanent JSON på IPFS"
ipfs_list	Lista dina uppladdade filer	"Visa mina senaste uppladdningar"
ipfs_get	Hämta filmetadata via CID	"Vilken typ av fil är QmXyz...?"
ipfs_delete	Avpinna och radera en fil	"Radera QmXyz... från mitt konto"

Pinning

Verktyg	Beskrivning	Exempelfråga
ipfs_pin	Pinna ett befintligt CID från nätverket	"Pinna bafyabc... till mitt konto"
ipfs_pin_status	Kontrollera pinningsförlopp	"Är bafyabc... klar med pinning?"

Organisation

Verktyg	Beskrivning	Exempelfråga
ipfs_folders_list	Lista dina mappar	"Visa mina mappar"
ipfs_folders_create	Skapa en ny mapp	"Skapa en mapp som heter nft-metadata"

Konto

Verktyg	Beskrivning	Exempelfråga
ipfs_profile	Hämta info om plan, lagring och bandbredd	"Hur mycket lagring använder jag?"
ipfs_analytics	Hämta daglig bandbredds- och filstatistik	"Visa min bandbreddsanvändning denna vecka"

Exempelarbetsflöden

Publicera en statisk webbplats

Du: Ladda upp innehållet i min dist/-mapp till IPFS
Claude: [laddar upp varje fil, returnerar CID:er]

Du: Vad är CID för index.html?
Claude: [anropar ipfs_get]
     → QmXyz... — https://ipfs.ninja/ipfs/QmXyz...

NFT-metadata

Du: Skapa en mapp som heter "my-collection" och ladda upp denna metadata-JSON
Claude: [anropar ipfs_folders_create, sedan ipfs_upload_json]
     → Mapp: my-collection
     → CID: QmAbc... — permanent metadata-URL redo för ditt smarta kontrakt

Övervaka användning

Du: Är jag nära min lagringsgräns?
Claude: [anropar ipfs_profile]
     → Plan: Bodhi, Lagring: 45.2 MB / 100 GB (0.04%)
     → Du har gott om utrymme.

Du: Visa min bandbredd denna vecka
Claude: [anropar ipfs_analytics med days=7]
     → 2.3 MB bandbredd, 45 förfrågningar under 3 dagar

Pinna innehåll från nätverket

Du: Pinna IPFS readme på QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG
Claude: [anropar ipfs_pin]
     → Pinning initierad! Status: pinnar

Du: Är det klart?
Claude: [anropar ipfs_pin_status]
     → Status: pinnad, Storlek: 0.008 MB

Felsökning

"IPFS_NINJA_API_KEY environment variable is required"

API-nyckeln är inte angiven. Se till att env-sektionen i din MCP-konfiguration har rätt nyckel.

"API error 402: not enough storage"

Du har nått ditt plans lagringsgräns. Uppgradera på ipfs.ninja/pricing eller radera oanvända filer.

"API error 403: Forbidden"

Din API-nyckel kan vara ogiltig eller utgången. Skapa en ny på Instrumentpanel > API-nycklar.

Servern visas inte i /mcp

Se till att du startade om Claude Code efter att du lade till MCP-servern. Kontrollera att Node.js 18+ är installerat (node --version).