MCP serveris

Izmantojiet IPFS Ninja tieši no AI kodēšanas palīgiem, piemēram, Claude Code, Cursor un Windsurf. Augšupielādējiet failus, piespraudiet CID, pārvaldiet mapes un pārbaudiet lietojumu — visu no savas AI sarunas.

Kas ir MCP?

Model Context Protocol (MCP) ir atvērts standarts AI palīgu savienošanai ar ārējiem rīkiem un datu avotiem. IPFS Ninja MCP serveris piedāvā 11 rīkus, ko AI modeļi var izsaukt sarunu laikā, lai mijiedarbotos ar jūsu IPFS Ninja kontu.

Instalēšana

npm pakotne

@ipfs-ninja/mcp-server

Pieejama npm vietnē. Nav nepieciešama globāla instalēšana — darbojas caur npx.

Priekšnosacījumi

• Instalēts Node.js 18+
• IPFS Ninja API atslēga (iegūstiet to Dashboard > API Keys)

Iestatīšana Claude Code

1. solis: Iegūstiet savu API atslēgu

1. Reģistrējieties ipfs.ninja (bezmaksas)
2. Dodieties uz Dashboard > API Keys
3. Noklikšķiniet uz Create API key un nokopējiet pilno atslēgu (tiek parādīta tikai vienu reizi)

2. solis: Pievienojiet MCP serveri

Izpildiet šo komandu savā terminālī:

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

Vai manuāli pievienojiet savam .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. solis: Restartējiet Claude Code

Aizveriet un atveriet Claude Code no jauna. Ierakstiet /mcp, lai pārbaudītu, vai IPFS Ninja serveris ir savienots.

4. solis: Sāciet lietot

Vienkārši sarunājieties ar Claude dabiski:

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"

Iestatīšana Cursor / Windsurf

Pievienojiet saviem MCP iestatījumiem (Settings > MCP Servers):

Iestatījums	Vērtība
Name	ipfs-ninja
Transport	stdio
Command	npx
Args	-y @ipfs-ninja/mcp-server
Environment	IPFS_NINJA_API_KEY=bws_...

Pieejamie rīki

Failu operācijas

Rīks	Apraksts	Piemēra uzvedne
ipfs_upload	Augšupielādēt faila saturu (base64 vai teksts)	"Upload this HTML file to IPFS"
ipfs_upload_json	Augšupielādēt JSON objektu	"Store this config as a permanent JSON on IPFS"
ipfs_list	Uzskaitīt jūsu augšupielādētos failus	"Show my recent uploads"
ipfs_get	Iegūt faila metadatus pēc CID	"What type of file is QmXyz...?"
ipfs_delete	Atspraust un dzēst failu	"Delete QmXyz... from my account"

Piespraušana

Rīks	Apraksts	Piemēra uzvedne
ipfs_pin	Piespraust esošu CID no tīkla	"Pin bafyabc... to my account"
ipfs_pin_status	Pārbaudīt piespraušanas progresu	"Is bafyabc... done pinning?"

Organizēšana

Rīks	Apraksts	Piemēra uzvedne
ipfs_folders_list	Uzskaitīt jūsu mapes	"Show my folders"
ipfs_folders_create	Izveidot jaunu mapi	"Create a folder called nft-metadata"

Konts

Rīks	Apraksts	Piemēra uzvedne
ipfs_profile	Iegūt plāna, krātuves un joslas platuma informāciju	"How much storage am I using?"
ipfs_analytics	Iegūt ikdienas joslas platuma un failu statistiku	"Show my bandwidth usage this week"

Piemēru darbplūsmas

Statiskas vietnes izvietošana

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 metadati

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

Lietojuma uzraudzība

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

Satura piespraušana no tīkla

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

Problēmu novēršana

"IPFS_NINJA_API_KEY environment variable is required"

API atslēga nav iestatīta. Pārliecinieties, ka jūsu MCP konfigurācijas env sadaļā ir norādīta pareizā atslēga.

"API error 402: not enough storage"

Jūs esat sasnieguši sava plāna krātuves limitu. Jauniniet plānu ipfs.ninja/pricing vai dzēsiet neizmantotos failus.

"API error 403: Forbidden"

Jūsu API atslēga var būt nederīga vai novecojusi. Izveidojiet jaunu Dashboard > API Keys.

Serveris neparādās /mcp

Pārliecinieties, ka pēc MCP servera pievienošanas esat restartējuši Claude Code. Pārbaudiet, vai ir instalēts Node.js 18+ (node --version).