MCP Server

ใช้ IPFS Ninja โดยตรงจาก AI coding assistant เช่น Claude Code, Cursor และ Windsurf อัปโหลดไฟล์ pin CID จัดการโฟลเดอร์ และตรวจสอบการใช้งาน -- ทั้งหมดจากการสนทนากับ AI ของคุณ

MCP คืออะไร?

Model Context Protocol (MCP) คือมาตรฐานเปิดสำหรับเชื่อมต่อ AI assistant กับเครื่องมือและแหล่งข้อมูลภายนอก MCP server ของ IPFS Ninja มีเครื่องมือ 11 ตัวที่ AI model สามารถเรียกใช้ระหว่างการสนทนาเพื่อโต้ตอบกับบัญชี IPFS Ninja ของคุณ

การติดตั้ง

แพ็กเกจ npm

@ipfs-ninja/mcp-server

มีให้บน npm ไม่ต้องติดตั้งแบบ global -- รันผ่าน npx

ข้อกำหนดเบื้องต้น

• ติดตั้ง Node.js 18+ แล้ว
• API key ของ IPFS Ninja (รับได้ที่ แดชบอร์ด > API Keys)

ตั้งค่าสำหรับ Claude Code

ขั้นตอนที่ 1: รับ API key

1. สมัครสมาชิกที่ ipfs.ninja (ฟรี)
2. ไปที่ แดชบอร์ด > API Keys
3. คลิก Create API key และคัดลอก key ทั้งหมด (แสดงเพียงครั้งเดียว)

ขั้นตอนที่ 2: เพิ่ม MCP server

รันคำสั่งนี้ในเทอร์มินัลของคุณ:

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

หรือเพิ่มด้วยตนเองในไฟล์ .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: รีสตาร์ท Claude Code

ปิดและเปิด Claude Code ใหม่ พิมพ์ /mcp เพื่อตรวจสอบว่า IPFS Ninja server เชื่อมต่อแล้ว

ขั้นตอนที่ 4: เริ่มใช้งาน

แค่พูดคุยกับ Claude ตามธรรมชาติ:

คุณ: อัปโหลด README.md ของฉันไปยัง IPFS
คุณ: แสดงไฟล์ล่าสุดของฉัน
คุณ: ฉันใช้พื้นที่เก็บข้อมูลเท่าไหร่?
คุณ: Pin bafyabc123... จากเครือข่าย IPFS
คุณ: สร้างโฟลเดอร์ชื่อ "project-assets"

ตั้งค่าสำหรับ Cursor / Windsurf

เพิ่มในการตั้งค่า MCP ของคุณ (Settings > MCP Servers):

การตั้งค่า	ค่า
Name	ipfs-ninja
Transport	stdio
Command	npx
Args	-y @ipfs-ninja/mcp-server
Environment	IPFS_NINJA_API_KEY=bws_...

เครื่องมือที่มีให้ใช้

การดำเนินการกับไฟล์

เครื่องมือ	คำอธิบาย	ตัวอย่างคำสั่ง
ipfs_upload	อัปโหลดเนื้อหาไฟล์ (base64 หรือข้อความ)	"อัปโหลดไฟล์ HTML นี้ไปยัง IPFS"
ipfs_upload_json	อัปโหลด JSON object	"เก็บ config นี้เป็น JSON ถาวรบน IPFS"
ipfs_list	ลิสต์ไฟล์ที่อัปโหลดของคุณ	"แสดงไฟล์ที่อัปโหลดล่าสุดของฉัน"
ipfs_get	รับข้อมูลเมตาของไฟล์จาก CID	"ไฟล์ QmXyz... เป็นประเภทอะไร?"
ipfs_delete	ถอน pin และลบไฟล์	"ลบ QmXyz... จากบัญชีของฉัน"

การ Pin

เครื่องมือ	คำอธิบาย	ตัวอย่างคำสั่ง
ipfs_pin	Pin CID ที่มีอยู่จากเครือข่าย	"Pin bafyabc... ไปยังบัญชีของฉัน"
ipfs_pin_status	ตรวจสอบความคืบหน้าการ pin	"bafyabc... pin เสร็จหรือยัง?"

การจัดระเบียบ

เครื่องมือ	คำอธิบาย	ตัวอย่างคำสั่ง
ipfs_folders_list	ลิสต์โฟลเดอร์ของคุณ	"แสดงโฟลเดอร์ของฉัน"
ipfs_folders_create	สร้างโฟลเดอร์ใหม่	"สร้างโฟลเดอร์ชื่อ nft-metadata"

บัญชี

เครื่องมือ	คำอธิบาย	ตัวอย่างคำสั่ง
ipfs_profile	รับข้อมูลแผน พื้นที่จัดเก็บ และแบนด์วิดท์	"ฉันใช้พื้นที่จัดเก็บเท่าไหร่?"
ipfs_analytics	รับสถิติแบนด์วิดท์และไฟล์รายวัน	"แสดงการใช้แบนด์วิดท์ของฉันสัปดาห์นี้"

ตัวอย่างเวิร์กโฟลว์

เผยแพร่เว็บไซต์แบบ static

คุณ: อัปโหลดเนื้อหาในโฟลเดอร์ dist/ ของฉันไปยัง IPFS
Claude: [อัปโหลดแต่ละไฟล์ ส่งกลับ CID]

คุณ: CID ของ index.html คืออะไร?
Claude: [เรียก ipfs_get]
     → QmXyz... — https://ipfs.ninja/ipfs/QmXyz...

NFT metadata

คุณ: สร้างโฟลเดอร์ชื่อ "my-collection" และอัปโหลด metadata JSON นี้
Claude: [เรียก ipfs_folders_create จากนั้น ipfs_upload_json]
     → โฟลเดอร์: my-collection
     → CID: QmAbc... — URL metadata ถาวรพร้อมใช้สำหรับ smart contract ของคุณ

ติดตามการใช้งาน

คุณ: ฉันใกล้ถึงขีดจำกัดพื้นที่จัดเก็บหรือยัง?
Claude: [เรียก ipfs_profile]
     → แผน: Bodhi, พื้นที่: 45.2 MB / 100 GB (0.04%)
     → คุณมีพื้นที่เหลือเฟือ

คุณ: แสดงแบนด์วิดท์ของฉันสัปดาห์นี้
Claude: [เรียก ipfs_analytics ด้วย days=7]
     → 2.3 MB แบนด์วิดท์, 45 คำขอใน 3 วัน

Pin เนื้อหาจากเครือข่าย

คุณ: Pin IPFS readme ที่ QmYwAPJzv5CZsnA625s3Xf2nemtYgPpHdWEz79ojWnPbdG
Claude: [เรียก ipfs_pin]
     → เริ่มการ pin แล้ว! สถานะ: กำลัง pin

คุณ: เสร็จหรือยัง?
Claude: [เรียก ipfs_pin_status]
     → สถานะ: pin แล้ว, ขนาด: 0.008 MB

การแก้ไขปัญหา

"IPFS_NINJA_API_KEY environment variable is required"

ยังไม่ได้ตั้งค่า API key ตรวจสอบว่าส่วน env ในการตั้งค่า MCP ของคุณมี key ที่ถูกต้อง

"API error 402: not enough storage"

คุณใช้พื้นที่จัดเก็บถึงขีดจำกัดของแผนแล้ว อัปเกรดที่ ipfs.ninja/pricing หรือลบไฟล์ที่ไม่ใช้

"API error 403: Forbidden"

API key ของคุณอาจไม่ถูกต้องหรือหมดอายุ สร้างใหม่ที่ แดชบอร์ด > API Keys

Server ไม่แสดงใน /mcp

ตรวจสอบว่าคุณรีสตาร์ท Claude Code แล้วหลังจากเพิ่ม MCP server ตรวจสอบว่าติดตั้ง Node.js 18+ แล้ว (node --version)