Serveur MCP

Utilisez IPFS Ninja directement depuis vos assistants de codage IA comme Claude Code, Cursor et Windsurf. Telechargez des fichiers, epinglez des CID, gerez des dossiers et verifiez votre utilisation — le tout depuis votre conversation IA.

Qu'est-ce que MCP ?

Model Context Protocol (MCP) est un standard ouvert pour connecter les assistants IA a des outils et sources de donnees externes. Le serveur MCP d'IPFS Ninja expose 11 outils que les modeles IA peuvent appeler pendant les conversations pour interagir avec votre compte IPFS Ninja.

Installation

Paquet npm

@ipfs-ninja/mcp-server

Disponible sur npm. Aucune installation globale necessaire — fonctionne via npx.

Prerequis

• Node.js 18+ installe
• Une cle API IPFS Ninja (obtenez-en une sur Tableau de bord > Cles API)

Configuration pour Claude Code

Etape 1 : Obtenez votre cle API

1. Inscrivez-vous sur ipfs.ninja (gratuit)
2. Allez dans Tableau de bord > Cles API
3. Cliquez sur Create API key et copiez la cle complete (affichee une seule fois)

Etape 2 : Ajoutez le serveur MCP

Executez cette commande dans votre 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

Ou ajoutez manuellement dans votre .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"
      }
    }
  }
}

Etape 3 : Redemarrez Claude Code

Quittez et rouvrez Claude Code. Tapez /mcp pour verifier que le serveur IPFS Ninja est connecte.

Etape 4 : Commencez a l'utiliser

Parlez simplement a Claude naturellement :

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"

Configuration pour Cursor / Windsurf

Ajoutez dans vos parametres MCP (Settings > MCP Servers) :

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

Outils disponibles

Operations sur les fichiers

Outil	Description	Exemple de prompt
ipfs_upload	Telecharger du contenu (base64 ou texte)	"Telecharge ce fichier HTML sur IPFS"
ipfs_upload_json	Telecharger un objet JSON	"Stocke cette config en JSON permanent sur IPFS"
ipfs_list	Lister vos fichiers telecharges	"Montre mes telechargements recents"
ipfs_get	Obtenir les metadonnees d'un fichier par CID	"Quel type de fichier est QmXyz... ?"
ipfs_delete	Desepingler et supprimer un fichier	"Supprime QmXyz... de mon compte"

Epinglage

Outil	Description	Exemple de prompt
ipfs_pin	Epingler un CID existant du reseau	"Epingle bafyabc... sur mon compte"
ipfs_pin_status	Verifier la progression de l'epinglage	"Est-ce que bafyabc... a fini d'etre epingle ?"

Organisation

Outil	Description	Exemple de prompt
ipfs_folders_list	Lister vos dossiers	"Montre mes dossiers"
ipfs_folders_create	Creer un nouveau dossier	"Cree un dossier appele nft-metadata"

Compte

Outil	Description	Exemple de prompt
ipfs_profile	Obtenir les infos de plan, stockage et bande passante	"Combien de stockage j'utilise ?"
ipfs_analytics	Obtenir les stats quotidiennes de bande passante et fichiers	"Montre mon utilisation de bande passante cette semaine"

Exemples de workflows

Deployer un site statique

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...

Metadonnees NFT

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

Surveiller l'utilisation

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

Epingler du contenu depuis le reseau

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

Depannage

"IPFS_NINJA_API_KEY environment variable is required"

La cle API n'est pas configuree. Assurez-vous que la section env de votre configuration MCP contient la bonne cle.

"API error 402: not enough storage"

Vous avez atteint la limite de stockage de votre plan. Mettez a niveau sur ipfs.ninja/pricing ou supprimez les fichiers inutilises.

"API error 403: Forbidden"

Votre cle API est peut-etre invalide ou expiree. Creez-en une nouvelle sur Tableau de bord > Cles API.

Le serveur n'apparait pas dans /mcp

Assurez-vous d'avoir redemarre Claude Code apres avoir ajoute le serveur MCP. Verifiez que Node.js 18+ est installe (node --version).