MCP server overview
Use Meshkit as a tool inside Cursor, Claude Desktop, or any MCP-compatible AI agent.
@ipfs-meshkit/mcp is a Model Context Protocol server that wraps all Meshkit operations as AI-agent tools. Once configured, your AI assistant can upload files to IPFS, pin content, manage IPNS records, and more — without any custom integration code.
How it works
AI client → stdio → @ipfs-meshkit/mcp → Meshkit → Kubo RPCThe MCP server connects to your Kubo node(s) at startup, then communicates with AI clients over stdio (stdin/stdout JSON-RPC). Log output goes to stderr only, so it never pollutes the tool stream.
Install
# Run directly (no install required)
npx -y @ipfs-meshkit/mcp
# Or install globally
npm install -g @ipfs-meshkit/mcp
meshkit-mcpPrerequisites
- Node.js 20+
- A running Kubo node or
MESHKIT_LOCAL_NODE=true(requiresipfson PATH)
Available tools
| Tool | Description |
|---|---|
ipfs_upload | Upload text or base64 content; returns CID |
ipfs_retrieve | Retrieve content by CID |
ipfs_pin | Pin a CID on the node |
ipfs_list_pins | List all pinned CIDs |
ipfs_publish_name | Publish an IPNS record |
ipfs_resolve | Resolve an IPNS name and retrieve content |
ipfs_generate_key | Create a named IPNS signing key |
ipfs_list_keys | List IPNS keys in the keystore |
See the Tools reference for full input/output schemas.