Introduction
Meshkit is a Node.js SDK for Kubo (IPFS) — upload, retrieve, pin, and manage IPNS records with failover and local daemon support.
Meshkit (@ipfs-meshkit/meshkit) gives Node.js apps a typed, batteries-included interface to Kubo — the reference IPFS implementation.
npm install @ipfs-meshkit/meshkitWhat it does
| Feature | Detail |
|---|---|
| Storage | Upload bytes, retrieve by CID, pin content |
| Multi-node failover | Pass multiple Kubo URLs; Meshkit tries each healthy node in order |
| Local daemon | localNode: true — start or attach to Kubo automatically |
| IPNS | Publish mutable pointers, resolve names, manage keys |
| MCP server | Expose all operations as AI-agent tools in Cursor, Claude Desktop, etc. |
Quick example
import { init, setupGracefulShutdown } from '@ipfs-meshkit/meshkit';
const { meshkit, localNode } = await init({ localNode: true });
setupGracefulShutdown(localNode);
const cid = await meshkit.upload(new TextEncoder().encode('hello'));
await meshkit.pin(cid);
const bytes = await meshkit.retrieve(cid);
console.log(new TextDecoder().decode(bytes)); // helloRequirements
- Node.js 20+
- A running Kubo daemon or set
localNode: true(requiresipfsonPATH)
Packages
| Package | Description |
|---|---|
@ipfs-meshkit/meshkit | Main SDK — everything you need |
@ipfs-meshkit/mcp | MCP server for AI agent integration |