MCP Sunucusu

IPFS Ninja'yı doğrudan Claude Code, Cursor ve Windsurf gibi yapay zeka kodlama asistanlarından kullanın. Dosya yükleyin, CID sabitleyin, klasörleri yönetin ve kullanımınızı kontrol edin — hepsi yapay zeka sohbetinizden.

MCP Nedir?

Model Context Protocol (MCP), yapay zeka asistanlarını harici araçlara ve veri kaynaklarına bağlamak için açık bir standarttır. IPFS Ninja MCP sunucusu, yapay zeka modellerinin sohbetler sırasında IPFS Ninja hesabınızla etkileşim kurmak için çağırabileceği 11 araç sunar.

Kurulum

npm paketi

@ipfs-ninja/mcp-server

npm üzerinde mevcuttur. Global kurulum gerekmez — npx ile çalışır.

Ön Koşullar

Node.js 18+ kurulu olmalı
Bir IPFS Ninja API anahtarı (Dashboard > API Keys adresinden alın)

Claude Code Kurulumu

Adım 1: API anahtarınızı alın

ipfs.ninja adresinden kaydolun (ücretsiz)
Dashboard > API Keys sayfasına gidin
Create API key butonuna tıklayın ve tam anahtarı kopyalayın (yalnızca bir kez gösterilir)

Adım 2: MCP sunucusunu ekleyin

Terminalinizde şu komutu çalıştırın:

bash

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

Ya da .claude/settings.json dosyanıza manuel olarak ekleyin:

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"
      }
    }
  }
}

Adım 3: Claude Code'u yeniden başlatın

Claude Code'u kapatıp yeniden açın. IPFS Ninja sunucusunun bağlı olduğunu doğrulamak için /mcp yazın.

Adım 4: Kullanmaya başlayın

Claude ile doğal bir şekilde konuşmanız yeterli:

Siz: README.md dosyamı IPFS'e yükle
Siz: Son dosyalarımı listele
Siz: Ne kadar depolama alanı kullanıyorum?
Siz: bafyabc123... adresini IPFS ağından sabitle
Siz: "project-assets" adında bir klasör oluştur

Cursor / Windsurf Kurulumu

MCP ayarlarınıza ekleyin (Settings > MCP Servers):

Ayar	Değer
Name	`ipfs-ninja`
Transport	`stdio`
Command	`npx`
Args	`-y @ipfs-ninja/mcp-server`
Environment	`IPFS_NINJA_API_KEY=bws_...`

Mevcut Araçlar

Dosya işlemleri

Araç	Açıklama	Örnek komut
`ipfs_upload`	Dosya içeriği yükle (base64 veya metin)	"Bu HTML dosyasını IPFS'e yükle"
`ipfs_upload_json`	Bir JSON nesnesi yükle	"Bu yapılandırmayı IPFS'te kalıcı JSON olarak sakla"
`ipfs_list`	Yüklenen dosyalarınızı listele	"Son yüklemelerimi göster"
`ipfs_get`	CID ile dosya meta verilerini al	"QmXyz... ne tür bir dosya?"
`ipfs_delete`	Sabitlemeyi kaldır ve dosyayı sil	"QmXyz... dosyasını hesabımdan sil"

Sabitleme

Araç	Açıklama	Örnek komut
`ipfs_pin`	Ağdan mevcut bir CID'yi sabitle	"bafyabc... adresini hesabıma sabitle"
`ipfs_pin_status`	Sabitleme durumunu kontrol et	"bafyabc... sabitleme tamamlandı mı?"

Düzenleme

Araç	Açıklama	Örnek komut
`ipfs_folders_list`	Klasörlerinizi listele	"Klasörlerimi göster"
`ipfs_folders_create`	Yeni bir klasör oluştur	"nft-metadata adında bir klasör oluştur"

Hesap

Araç	Açıklama	Örnek komut
`ipfs_profile`	Plan, depolama, bant genişliği bilgisi al	"Ne kadar depolama alanı kullanıyorum?"
`ipfs_analytics`	Günlük bant genişliği ve dosya istatistikleri al	"Bu haftaki bant genişliği kullanımımı göster"

Örnek İş Akışları

Statik site dağıtımı

Siz: dist/ klasörümün içeriğini IPFS'e yükle
Claude: [her dosyayı yükler, CID'leri döndürür]

Siz: index.html'nin CID'si ne?
Claude: [ipfs_get çağrısı yapar]
     → QmXyz... — https://ipfs.ninja/ipfs/QmXyz...

NFT meta verileri

Siz: "my-collection" adında bir klasör oluştur ve bu metadata JSON'ını yükle
Claude: [ipfs_folders_create, ardından ipfs_upload_json çağrısı yapar]
     → Klasör: my-collection
     → CID: QmAbc... — akıllı sözleşmeniz için kalıcı metadata URL'si hazır

Kullanım takibi

Siz: Depolama sınırıma yaklaşıyor muyum?
Claude: [ipfs_profile çağrısı yapar]
     → Plan: Bodhi, Depolama: 45.2 MB / 100 GB (%0.04)
     → Bol miktarda yeriniz var.

Siz: Bu haftaki bant genişliğimi göster
Claude: [ipfs_analytics çağrısı yapar, days=7]
     → 2.3 MB bant genişliği, 3 günde 45 istek

Ağdan içerik sabitleme

Siz: QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG adresindeki IPFS readme'sini sabitle
Claude: [ipfs_pin çağrısı yapar]
     → Sabitleme başlatıldı! Durum: sabitleniyor

Siz: Tamamlandı mı?
Claude: [ipfs_pin_status çağrısı yapar]
     → Durum: sabitlendi, Boyut: 0.008 MB

Sorun Giderme

"IPFS_NINJA_API_KEY environment variable is required"

API anahtarı ayarlanmamış. MCP yapılandırmanızdaki env bölümünde doğru anahtarın olduğundan emin olun.

"API error 402: not enough storage"

Planınızın depolama sınırına ulaştınız. ipfs.ninja/pricing adresinden yükseltin veya kullanılmayan dosyaları silin.

"API error 403: Forbidden"

API anahtarınız geçersiz veya süresi dolmuş olabilir. Dashboard > API Keys adresinden yeni bir tane oluşturun.

Sunucu `/mcp` içinde görünmüyor

MCP sunucusunu ekledikten sonra Claude Code'u yeniden başlattığınızdan emin olun. Node.js 18+ kurulu olduğunu kontrol edin (node --version).

MCP Sunucusu ​

MCP Nedir? ​

Kurulum ​

npm paketi ​

Ön Koşullar ​

Claude Code Kurulumu ​

Adım 1: API anahtarınızı alın ​

Adım 2: MCP sunucusunu ekleyin ​

Adım 3: Claude Code'u yeniden başlatın ​

Adım 4: Kullanmaya başlayın ​

Cursor / Windsurf Kurulumu ​

Mevcut Araçlar ​

Dosya işlemleri ​

Sabitleme ​

Düzenleme ​

Hesap ​

Örnek İş Akışları ​

Statik site dağıtımı ​

NFT meta verileri ​

Kullanım takibi ​

Ağdan içerik sabitleme ​

Sorun Giderme ​

"IPFS_NINJA_API_KEY environment variable is required" ​

"API error 402: not enough storage" ​

"API error 403: Forbidden" ​

Sunucu /mcp içinde görünmüyor ​