MCP Server

Kasuta IPFS Ninja't otse tehisintellekti programmeerimisassistentidest nagu Claude Code, Cursor ja Windsurf. Laadi faile üles, kinnita CID-e, halda kaustu ja kontrolli kasutust — kõik oma tehisintellekti vestlusest.

Mis on MCP?

Model Context Protocol (MCP) on avatud standard tehisintellekti assistentide ühendamiseks väliste tööriistade ja andmeallikatega. IPFS Ninja MCP server pakub 11 tööriista, mida tehisintellekti mudelid saavad vestluste ajal kutsuda, et suhelda sinu IPFS Ninja kontoga.

Paigaldamine

npm pakett

@ipfs-ninja/mcp-server

Saadaval npm-is. Globaalset paigaldamist pole vaja — käivitub npx kaudu.

Eeltingimused

• Node.js 18+ paigaldatud
• IPFS Ninja API-võti (loo üks Dashboard > API Keys lehel)

Seadistamine Claude Code jaoks

Samm 1: Hangi oma API-võti

1. Registreeru ipfs.ninja lehel (tasuta)
2. Mine Dashboard > API Keys
3. Kliki Create API key ja kopeeri täielik võti (näidatakse ainult üks kord)

Samm 2: Lisa MCP server

Käivita see käsk oma terminalis:

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

Või lisa käsitsi oma .claude/settings.json faili:

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

Samm 3: Taaskäivita Claude Code

Sulge ja ava Claude Code uuesti. Sisesta /mcp, et kontrollida, kas IPFS Ninja server on ühendatud.

Samm 4: Hakka kasutama

Lihtsalt räägi Claude'iga loomulikult:

Sina: Laadi mu README.md IPFS-i üles
Sina: Loetele mu viimased failid
Sina: Kui palju salvestusruumi ma kasutan?
Sina: Kinnita bafyabc123... IPFS-i võrgust
Sina: Loo kaust nimega "project-assets"

Seadistamine Cursor / Windsurf jaoks

Lisa oma MCP seadistustesse (Settings > MCP Servers):

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

Saadaolevad tööriistad

Failioperatsioonid

Tööriist	Kirjeldus	Näidis-prompt
ipfs_upload	Failisisu üleslaadimine (base64 või tekst)	„Laadi see HTML-fail IPFS-i üles"
ipfs_upload_json	JSON-objekti üleslaadimine	„Salvesta see konfiguratsioon püsiva JSON-ina IPFS-is"
ipfs_list	Sinu üleslaaditud failide loetlemine	„Näita mu viimaseid üleslaadimisi"
ipfs_get	Faili metaandmete pärimine CID järgi	„Mis tüüpi fail on QmXyz...?"
ipfs_delete	Kinnitamise eemaldamine ja faili kustutamine	„Kustuta QmXyz... mu kontolt"

Kinnitamine

Tööriist	Kirjeldus	Näidis-prompt
ipfs_pin	Olemasoleva CID kinnitamine võrgust	„Kinnita bafyabc... mu kontole"
ipfs_pin_status	Kinnitamise edenemise kontrollimine	„Kas bafyabc... kinnitamine on lõppenud?"

Organiseerimine

Tööriist	Kirjeldus	Näidis-prompt
ipfs_folders_list	Sinu kaustade loetlemine	„Näita mu kaustu"
ipfs_folders_create	Uue kausta loomine	„Loo kaust nimega nft-metadata"

Konto

Tööriist	Kirjeldus	Näidis-prompt
ipfs_profile	Plaani, salvestusruumi ja ribalaiuse info	„Kui palju salvestusruumi ma kasutan?"
ipfs_analytics	Päevane ribalaiuse ja failistatistika	„Näita mu ribalaiuse kasutust sel nädalal"

Näidistöövood

Staatilise saidi juurutamine

Sina: Laadi mu dist/ kausta sisu IPFS-i üles
Claude: [laadib iga faili üles, tagastab CID-d]

Sina: Mis on index.html CID?
Claude: [kutsub ipfs_get]
     → QmXyz... — https://ipfs.ninja/ipfs/QmXyz...

NFT metaandmed

Sina: Loo kaust nimega "my-collection" ja laadi see metaandmete JSON üles
Claude: [kutsub ipfs_folders_create, seejärel ipfs_upload_json]
     → Kaust: my-collection
     → CID: QmAbc... — püsiv metaandmete URL sinu smart contract'i jaoks

Kasutuse jälgimine

Sina: Kas ma olen oma salvestuslimiidi lähedal?
Claude: [kutsub ipfs_profile]
     → Plaan: Bodhi, Salvestusruum: 45.2 MB / 100 GB (0.04%)
     → Sul on ruumi küllaga.

Sina: Näita mu ribalaiust sel nädalal
Claude: [kutsub ipfs_analytics parameetriga days=7]
     → 2.3 MB ribalaiust, 45 päringut 3 päeva jooksul

Sisu kinnitamine võrgust

Sina: Kinnita IPFS readme aadressil QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG
Claude: [kutsub ipfs_pin]
     → Kinnitamine alustatud! Staatus: pinning

Sina: Kas see on valmis?
Claude: [kutsub ipfs_pin_status]
     → Staatus: pinned, Suurus: 0.008 MB

Veaotsing

"IPFS_NINJA_API_KEY environment variable is required"

API-võti pole määratud. Veendu, et sinu MCP konfiguratsiooni env osas on õige võti.

"API error 402: not enough storage"

Oled jõudnud oma plaani salvestuslimiidini. Uuenda plaani ipfs.ninja/pricing lehel või kustuta kasutamata failid.

"API error 403: Forbidden"

Sinu API-võti võib olla kehtetu või aegunud. Loo uus Dashboard > API Keys lehel.

Server ei ilmu /mcp all

Veendu, et taaskäivitasid Claude Code pärast MCP serveri lisamist. Kontrolli, et Node.js 18+ on paigaldatud (node --version).