ipfs-connector-pinata

A Model Context Protocol (MCP) bridge designed to grant Claude direct interaction capabilities with the Pinata service layer, specifically targeting IPFS interactions (public and private).

Configuration Guide

Prerequisites

• A runtime environment supporting Node.js version 18 or newer.
• Valid authentication credentials (JWT API Key) secured from a Pinata account.

Deployment Instructions

The method for incorporating this tool varies based on the Claude interface being utilized:

For Claude Code Environments

Execute the command sequence claude mcp add and provide the subsequent parameters when prompted:

Server Name: ipfs-pinata
Server Scope: Project or Global assignment
Server Command: npx
Command Arguments: pinata-mcp /data/path/one /data/path/two
Environment Variables: PINATA_JWT=<YOUR_SECRET_TOKEN>,GATEWAY_URL=custom.mypinata.cloud

For Claude Desktop Environments

Incorporate the following JSON structure into your local claude_desktop_config.json file:

{
  "mcpServers": {
    "ipfs-pinata": {
      "command": "npx",
      "args": [
        "pinata-mcp",
        "/data/path/to/allowlist"
      ],
      "env": {
        "PINATA_JWT": "<YOUR_SECRET_TOKEN>",
        "GATEWAY_URL": "custom.mypinata.cloud"
      }
    }
  }
}

Operational Capabilities

Once initialization is complete by launching Claude Code (claude) or Claude Desktop, the following functionalities are accessible:

Data Manipulation Functions

• Ingest files into Pinata (for distribution across public or proprietary IPFS networks).
• Query files based on identifiers (CID), filename, or MIME classification.
• Retrieve comprehensive metadata for a specific asset using its identifier.
• Modify asset metadata, including renaming and updating associated key-value attributes.
• Permanently erase assets from the Pinata service.

Organization & Grouping Functions

• Enumerate existing collections (groups), supporting optional filter criteria.
• Establish new organizational containers (groups).
• Fetch detailed information for a specified group ID.
• Revise group attributes.
• Decommission groups.
• Associate or disassociate files relative to defined groups.

Access Control & Retrieval

• Generate time-limited, secure access links for retrieving assets held privately on IPFS.
• Pull content streams directly from the designated IPFS gateway, with an option for local persistence.

Suggested Claude Interaction Examples

Illustrations for directing Claude to utilize the ipfs-connector-pinata tool:

Upload a visual asset to Pinata:
"Employ Pinata to store the image located at ~/Graphics/visual.png. Designate this as a restricted asset, labeling it 'Primary Visual Component'"

Locate specific assets:
"Scan my Pinata repository for all files adhering to the JPEG standard"

Establish a collection and populate it:
"On Pinata, construct a new collection named 'Archived Reports'. Subsequently, identify every document tagged as XML and assign them to this new collection"

Retrieve content via its unique hash:
"Obtain the data payload associated with CID QmY... and save the resultant file into the local 'Transfers' directory"

Support

Should operational challenges arise, please direct your inquiries via email.