MCP serveris

Naudokite IPFS Ninja tiesiogiai is AI kodavimo asistentu, tokiu kaip Claude Code, Cursor ir Windsurf. Ikelkite failus, prisekite CID, tvarkykite aplankus ir tikrinkite naudojima — visa tai is savo AI pokalbio.

Kas yra MCP?

Model Context Protocol (MCP) yra atviras standartas AI asistentu prijungimui prie isoriniu irankiu ir duomenu saltiniu. IPFS Ninja MCP serveris pateikia 11 irankiu, kuriuos AI modeliai gali iskviesti pokalbiu metu, kad saveikautu su jusu IPFS Ninja paskyra.

Diegimas

npm paketas

@ipfs-ninja/mcp-server

Pasiekiamas npm platformoje. Globalus diegimas nereikalingas — paleidziamas per npx.

Bustinosios salygos

• Idiegtas Node.js 18+
• IPFS Ninja API raktas (gaukite Dashboard > API Keys)

Claude Code nustatymas

1 zingsnis: Gaukite savo API rakta

1. Uzsiregistruokite ipfs.ninja (nemokamai)
2. Eikite i Dashboard > API Keys
3. Spustelekite Create API key ir nukopijuokite visa rakta (rodomas tik viena karta)

2 zingsnis: Pridekite MCP serveri

Ivykdykite sia komanda savo terminale:

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

Arba pridekite rankiniu budu i savo .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"
      }
    }
  }
}

3 zingsnis: Paleiskite Claude Code is naujo

Isjunkite ir vel atidarykite Claude Code. Iveskite /mcp, kad patikrintumete, ar IPFS Ninja serveris prijungtas.

4 zingsnis: Pradekite naudoti

Tiesiog kalbekite su Claude naturaliai:

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"

Cursor / Windsurf nustatymas

Pridekite prie savo MCP nustatymu (Settings > MCP Servers):

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

Pasiekiami irankiai

Failu operacijos

Irankis	Aprasymas	Prompt pavyzdys
ipfs_upload	Ikelti failo turini (base64 arba tekstas)	"Ikelk si HTML faila i IPFS"
ipfs_upload_json	Ikelti JSON objekta	"Issaugok sia konfiguracija kaip nuolatini JSON IPFS"
ipfs_list	Parodyti ikeltus failus	"Parodyk mano naujausius ikelimus"
ipfs_get	Gauti failo metaduomenis pagal CID	"Kokio tipo failas yra QmXyz...?"
ipfs_delete	Atsegti ir istrinti faila	"Istink QmXyz... is mano paskyros"

Prisegimas

Irankis	Aprasymas	Prompt pavyzdys
ipfs_pin	Prisegti esama CID is tinklo	"Prisek bafyabc... prie mano paskyros"
ipfs_pin_status	Patikrinti prisegimo eiga	"Ar bafyabc... jau prisegtas?"

Organizavimas

Irankis	Aprasymas	Prompt pavyzdys
ipfs_folders_list	Parodyti jusu aplankus	"Parodyk mano aplankus"
ipfs_folders_create	Sukurti nauja aplanka	"Sukurk aplanka pavadinimu nft-metadata"

Paskyra

Irankis	Aprasymas	Prompt pavyzdys
ipfs_profile	Gauti plano, saugyklos, praladumo info	"Kiek saugyklos vietos naudoju?"
ipfs_analytics	Gauti dienos praladumo ir failu statistika	"Parodyk mano praladumo naudojima sia savaite"

Darbo eigos pavyzdziai

Statines svetaines diegimas

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 metaduomenys

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

Naudojimo stebesena

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

Turinio prisegimas is tinklo

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

Triktiu salinimas

"IPFS_NINJA_API_KEY environment variable is required"

API raktas nenustatytas. Isitikinkite, kad env skyrius jusu MCP konfiguracijoje turi teisinga rakta.

"API error 402: not enough storage"

Pasiekete savo plano saugyklos limita. Atnaujinkite plana ipfs.ninja/pricing arba istrinkite nenaudojamus failus.

"API error 403: Forbidden"

Jusu API raktas gali buti negaliojantis arba pasibaiges. Sukurkite nauja Dashboard > API Keys.

Serveris nerodomas /mcp

Isitikinkite, kad paleidote Claude Code is naujo prideje MCP serveri. Patikrinkite, ar idiegtas Node.js 18+ (node --version).