MCP সার্ভার

Claude Code, Cursor এবং Windsurf-এর মতো AI কোডিং সহকারী থেকে সরাসরি IPFS Ninja ব্যবহার করুন। ফাইল আপলোড করুন, CID পিন করুন, ফোল্ডার পরিচালনা করুন এবং ব্যবহার পরীক্ষা করুন — সবকিছু আপনার AI কথোপকথন থেকে।

MCP কী?

Model Context Protocol (MCP) হল AI সহকারীদের বাহ্যিক টুল এবং ডেটা উৎসের সাথে সংযুক্ত করার একটি উন্মুক্ত মান। IPFS Ninja MCP সার্ভার ১১টি টুল প্রদান করে যা AI মডেলগুলি কথোপকথনের সময় আপনার IPFS Ninja অ্যাকাউন্টের সাথে ইন্টারঅ্যাক্ট করতে কল করতে পারে।

ইনস্টলেশন

npm প্যাকেজ

@ipfs-ninja/mcp-server

npm-এ উপলব্ধ। গ্লোবাল ইনস্টলের প্রয়োজন নেই — npx-এর মাধ্যমে চলে।

পূর্বশর্ত

• Node.js 18+ ইনস্টল করা
• একটি IPFS Ninja API কী (Dashboard > API Keys থেকে পান)

Claude Code-এর জন্য সেটআপ

ধাপ ১: আপনার API কী নিন

1. ipfs.ninja-তে সাইন আপ করুন (বিনামূল্যে)
2. Dashboard > API Keys-এ যান
3. Create API key ক্লিক করুন এবং সম্পূর্ণ কী কপি করুন (শুধুমাত্র একবার দেখানো হয়)

ধাপ ২: MCP সার্ভার যোগ করুন

আপনার টার্মিনালে এই কমান্ডটি চালান:

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

ধাপ ৩: Claude Code রিস্টার্ট করুন

Claude Code বন্ধ করে আবার খুলুন। /mcp টাইপ করে যাচাই করুন যে IPFS Ninja সার্ভার সংযুক্ত আছে।

ধাপ ৪: ব্যবহার শুরু করুন

শুধু Claude-এর সাথে স্বাভাবিকভাবে কথা বলুন:

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-এর জন্য সেটআপ

আপনার 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 বা টেক্সট)	"Upload this HTML file to IPFS"
ipfs_upload_json	একটি JSON অবজেক্ট আপলোড	"Store this config as a permanent JSON on IPFS"
ipfs_list	আপনার আপলোড করা ফাইলের তালিকা	"Show my recent uploads"
ipfs_get	CID দিয়ে ফাইলের মেটাডেটা পান	"What type of file is QmXyz...?"
ipfs_delete	একটি ফাইল আনপিন এবং মুছুন	"Delete QmXyz... from my account"

পিনিং

টুল	বিবরণ	উদাহরণ প্রম্পট
ipfs_pin	নেটওয়ার্ক থেকে একটি বিদ্যমান CID পিন করুন	"Pin bafyabc... to my account"
ipfs_pin_status	পিনিং-এর অগ্রগতি পরীক্ষা করুন	"Is bafyabc... done pinning?"

সংগঠন

টুল	বিবরণ	উদাহরণ প্রম্পট
ipfs_folders_list	আপনার ফোল্ডারের তালিকা	"Show my folders"
ipfs_folders_create	নতুন ফোল্ডার তৈরি	"Create a folder called nft-metadata"

অ্যাকাউন্ট

টুল	বিবরণ	উদাহরণ প্রম্পট
ipfs_profile	প্ল্যান, স্টোরেজ, ব্যান্ডউইথ তথ্য	"How much storage am I using?"
ipfs_analytics	দৈনিক ব্যান্ডউইথ এবং ফাইল পরিসংখ্যান	"Show my bandwidth usage this week"

উদাহরণ ওয়ার্কফ্লো

স্ট্যাটিক সাইট ডিপ্লয়

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 মেটাডেটা

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

ব্যবহার পর্যবেক্ষণ

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

নেটওয়ার্ক থেকে কন্টেন্ট পিন করা

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

সমস্যা সমাধান

"IPFS_NINJA_API_KEY environment variable is required"

API কী সেট করা হয়নি। নিশ্চিত করুন যে আপনার MCP কনফিগারেশনের env বিভাগে সঠিক কী আছে।

"API error 402: not enough storage"

আপনি আপনার প্ল্যানের স্টোরেজ সীমায় পৌঁছেছেন। ipfs.ninja/pricing-এ আপগ্রেড করুন অথবা অব্যবহৃত ফাইল মুছে ফেলুন।

"API error 403: Forbidden"

আপনার API কী অবৈধ বা মেয়াদোত্তীর্ণ হতে পারে। Dashboard > API Keys থেকে নতুন একটি তৈরি করুন।

সার্ভার /mcp-তে দেখা যাচ্ছে না

MCP সার্ভার যোগ করার পরে Claude Code রিস্টার্ট করেছেন কিনা নিশ্চিত করুন। Node.js 18+ ইনস্টল আছে কিনা পরীক্ষা করুন (node --version)।