MCP-palvelin

Kayta IPFS Ninja -palvelua suoraan tekoalykoodausavustajista kuten Claude Code, Cursor ja Windsurf. Lataa tiedostoja, kiinnita CID:ita, hallitse kansioita ja tarkista kaytto — kaikki suoraan tekoalykeskustelustasi.

Mika on MCP?

Model Context Protocol (MCP) on avoin standardi tekoalyavustajien yhdistamiseen ulkoisiin tyokaluihin ja tietolaheisiin. IPFS Ninja MCP -palvelin tarjoaa 11 tyokalua, joita tekoalymallit voivat kutsua keskustelujen aikana ollakseen vuorovaikutuksessa IPFS Ninja -tilisi kanssa.

Asennus

npm-paketti

@ipfs-ninja/mcp-server

Saatavilla npm:ssa. Globaalia asennusta ei tarvita — toimii npx:n kautta.

Edellytykset

• Node.js 18+ asennettuna
• IPFS Ninja API-avain (hanki Hallintapaneeli > API-avaimet)

Claude Code -asennus

Vaihe 1: Hanki API-avaimesi

1. Rekisteroidy osoitteessa ipfs.ninja (ilmainen)
2. Siirry kohtaan Hallintapaneeli > API-avaimet
3. Napsauta Create API key ja kopioi koko avain (naytetaan vain kerran)

Vaihe 2: Lisa MCP-palvelin

Suorita tama komento terminaalissasi:

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

Tai lisa manuaalisesti .claude/settings.json-tiedostoosi:

{
  "mcpServers": {
    "ipfs-ninja": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@ipfs-ninja/mcp-server"],
      "env": {
        "IPFS_NINJA_API_KEY": "bws_your_full_api_key_here"
      }
    }
  }
}

Vaihe 3: Kaynnista Claude Code uudelleen

Sulje ja avaa Claude Code uudelleen. Kirjoita /mcp varmistaaksesi, etta IPFS Ninja -palvelin on yhdistetty.

Vaihe 4: Aloita kaytto

Puhu Claudelle luonnollisesti:

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

Lisa MCP-asetuksiisi (Settings > MCP Servers):

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

Kaytettavissa olevat tyokalut

Tiedosto-operaatiot

Tyokalu	Kuvaus	Esimerkkikehote
ipfs_upload	Lataa tiedoston sisaltoa (base64 tai teksti)	"Lataa tama HTML-tiedosto IPFS:aan"
ipfs_upload_json	Lataa JSON-objekti	"Tallenna tama konfiguraatio pysyvana JSON-tiedostona IPFS:aan"
ipfs_list	Listaa ladatut tiedostosi	"Nayta viimeisimmat lataukseni"
ipfs_get	Hae tiedoston metatiedot CID:n perusteella	"Minka tyyppinen tiedosto on QmXyz...?"
ipfs_delete	Irrota kiinnitys ja poista tiedosto	"Poista QmXyz... tililtani"

Kiinnitys

Tyokalu	Kuvaus	Esimerkkikehote
ipfs_pin	Kiinnita olemassa oleva CID verkosta	"Kiinnita bafyabc... tililleni"
ipfs_pin_status	Tarkista kiinnityksen edistyminen	"Onko bafyabc... kiinnitys valmis?"

Jarjestely

Tyokalu	Kuvaus	Esimerkkikehote
ipfs_folders_list	Listaa kansiosi	"Nayta kansiosi"
ipfs_folders_create	Luo uusi kansio	"Luo kansio nimelta nft-metadata"

Tili

Tyokalu	Kuvaus	Esimerkkikehote
ipfs_profile	Hae suunnitelma-, tallennus- ja kaistanleveystiedot	"Kuinka paljon tallennustilaa kaytan?"
ipfs_analytics	Hae paivittaiset kaistanleveys- ja tiedostotilastot	"Nayta kaistanleveyskayttoni talta viikolta"

Esimerkkityonkulkuja

Staattisen sivuston julkaisu

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

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

Kayton seuranta

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

Sisallon kiinnittaminen verkosta

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

Vianmaaritys

"IPFS_NINJA_API_KEY environment variable is required"

API-avainta ei ole asetettu. Varmista, etta MCP-maarityksesi env-osiossa on oikea avain.

"API error 402: not enough storage"

Olet saavuttanut suunnitelmasi tallennusrajan. Paivita osoitteessa ipfs.ninja/pricing tai poista kayttamattomia tiedostoja.

"API error 403: Forbidden"

API-avaimesi voi olla virheellinen tai vanhentunut. Luo uusi Hallintapaneeli > API-avaimet -sivulla.

Palvelin ei nay /mcp-komennossa

Varmista, etta kaynistit Claude Coden uudelleen MCP-palvelimen lisamisen jalkeen. Tarkista, etta Node.js 18+ on asennettu (node --version).