Server MCP

Foloseste IPFS Ninja direct din asistenti AI pentru programare precum Claude Code, Cursor si Windsurf. Incarca fisiere, fixeaza CID-uri, gestioneaza foldere si verifica utilizarea — totul din conversatia ta cu AI-ul.

Ce este MCP?

Model Context Protocol (MCP) este un standard deschis pentru conectarea asistentilor AI la instrumente si surse de date externe. Serverul MCP IPFS Ninja expune 11 instrumente pe care modelele AI le pot apela in timpul conversatiilor pentru a interactiona cu contul tau IPFS Ninja.

Instalare

Pachet npm

@ipfs-ninja/mcp-server

Disponibil pe npm. Nu necesita instalare globala — ruleaza prin npx.

Cerinte preliminare

• Node.js 18+ instalat
• O cheie de API IPFS Ninja (obtine una de la Dashboard > API Keys)

Configurare pentru Claude Code

Pasul 1: Obtine cheia de API

1. Inregistreaza-te pe ipfs.ninja (gratuit)
2. Acceseaza Dashboard > API Keys
3. Apasa Create API key si copiaza cheia completa (afisata o singura data)

Pasul 2: Adauga serverul MCP

Ruleaza aceasta comanda in terminalul tau:

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

Sau adauga manual in .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"
      }
    }
  }
}

Pasul 3: Reporneste Claude Code

Inchide si redeschide Claude Code. Tasteaza /mcp pentru a verifica daca serverul IPFS Ninja este conectat.

Pasul 4: Incepe sa folosesti

Vorbeste cu Claude in mod natural:

Tu: Incarca README.md pe IPFS
Tu: Listeaza fisierele mele recente
Tu: Cat spatiu de stocare folosesc?
Tu: Fixeaza bafyabc123... din reteaua IPFS
Tu: Creeaza un folder numit "project-assets"

Configurare pentru Cursor / Windsurf

Adauga in setarile tale MCP (Settings > MCP Servers):

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

Instrumente Disponibile

Operatii cu fisiere

Instrument	Descriere	Exemplu de prompt
ipfs_upload	Incarca continut de fisier (base64 sau text)	"Incarca acest fisier HTML pe IPFS"
ipfs_upload_json	Incarca un obiect JSON	"Stocheaza acest config ca JSON permanent pe IPFS"
ipfs_list	Listeaza fisierele tale incarcate	"Arata-mi incarcerile recente"
ipfs_get	Obtine metadatele fisierului dupa CID	"Ce tip de fisier este QmXyz...?"
ipfs_delete	Elimina fixarea si sterge un fisier	"Sterge QmXyz... din contul meu"

Fixare (Pinning)

Instrument	Descriere	Exemplu de prompt
ipfs_pin	Fixeaza un CID existent din retea	"Fixeaza bafyabc... in contul meu"
ipfs_pin_status	Verifica progresul fixarii	"S-a terminat fixarea bafyabc...?"

Organizare

Instrument	Descriere	Exemplu de prompt
ipfs_folders_list	Listeaza folderele tale	"Arata-mi folderele mele"
ipfs_folders_create	Creeaza un folder nou	"Creeaza un folder numit nft-metadata"

Cont

Instrument	Descriere	Exemplu de prompt
ipfs_profile	Obtine informatii despre plan, stocare si latime de banda	"Cat spatiu de stocare folosesc?"
ipfs_analytics	Obtine statistici zilnice de latime de banda si fisiere	"Arata-mi utilizarea de latime de banda saptamana aceasta"

Exemple de Fluxuri de Lucru

Publicarea unui site static

Tu: Incarca continutul folderului meu dist/ pe IPFS
Claude: [incarca fiecare fisier, returneaza CID-uri]

Tu: Care este CID-ul pentru index.html?
Claude: [apeleaza ipfs_get]
     → QmXyz... — https://ipfs.ninja/ipfs/QmXyz...

Metadate NFT

Tu: Creeaza un folder numit "my-collection" si incarca acest JSON de metadate
Claude: [apeleaza ipfs_folders_create, apoi ipfs_upload_json]
     → Folder: my-collection
     → CID: QmAbc... — URL de metadate permanent gata pentru smart contract-ul tau

Monitorizarea utilizarii

Tu: Sunt aproape de limita de stocare?
Claude: [apeleaza ipfs_profile]
     → Plan: Bodhi, Stocare: 45.2 MB / 100 GB (0.04%)
     → Ai destul spatiu.

Tu: Arata-mi latimea de banda saptamana aceasta
Claude: [apeleaza ipfs_analytics cu days=7]
     → 2.3 MB latime de banda, 45 cereri in 3 zile

Fixarea continutului din retea

Tu: Fixeaza readme-ul IPFS la QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG
Claude: [apeleaza ipfs_pin]
     → Fixare initiata! Status: se fixeaza

Tu: S-a terminat?
Claude: [apeleaza ipfs_pin_status]
     → Status: fixat, Dimensiune: 0.008 MB

Depanare

"IPFS_NINJA_API_KEY environment variable is required"

Cheia de API nu este configurata. Asigura-te ca sectiunea env din configuratia ta MCP are cheia corecta.

"API error 402: not enough storage"

Ai atins limita de stocare a planului tau. Fa upgrade la ipfs.ninja/pricing sau sterge fisierele nefolosite.

"API error 403: Forbidden"

Cheia ta de API poate fi invalida sau expirata. Creeaza una noua la Dashboard > API Keys.

Serverul nu apare in /mcp

Asigura-te ca ai repornit Claude Code dupa adaugarea serverului MCP. Verifica daca Node.js 18+ este instalat (node --version).