piñata-mcp

Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona a Claude acceso a Pinata. Esta integración le permite interactuar con IPFS públicos y privados a través de la API de Pinata.

Configuración

Prerrequisitos

Node.js 18+ instalado
Una cuenta de Pinata con una clave API (JWT)

Instalación

La instalación dependerá de si estás utilizando Claude Code o Claude Desktop

Claude Code

Ejecute claude mcp add y siga las instrucciones con la siguiente información:

Server Name: pinata
Server Scope: Project or Global
Server Command: npx
Command Arguments: pinata-mcp /path/to/allowed/directories /another/path/to/allowed/directories
Environment Variables: PINATA_JWT=<YOUR_JWT>,GATEWAY_URL=example.mypinata.cloud

Escritorio de Claude

Agregue la siguiente configuración a claude_desktop_config.json

{
  "mcpServers": {
    "pinata": {
      "command": "npx",
      "args": [
        "pinata-mcp",
        "/path/to/allowed/directory"
      ],
      "env": {
        "PINATA_JWT": "<YOUR_JWT>",
        "GATEWAY_URL": "example.mypinata.cloud"
      }
    }
  }
}

Related MCP server: Spotify MCP Server

Uso

Para empezar a usar el MCP, inicie Claude Code con el comando claude o inicie Claude Desktop. A continuación, se muestran las operaciones disponibles:

Operaciones con archivos

Subir archivos a Pinata (IPFS público o privado)
Buscar archivos por nombre, CID o tipo MIME
Obtener detalles del archivo por ID
Actualizar los metadatos del archivo, incluidos el nombre y los valores clave
Eliminar archivos de Piñata

Operaciones de grupo

Lista de grupos con filtrado opcional
Crear grupos para organizar archivos
Obtener detalles del grupo por ID
Actualizar la información del grupo
Eliminar grupos
Agregar o quitar archivos a o de grupos

Acceso al contenido

Crear enlaces de descarga privados para acceder a archivos privados
Obtener contenido de la puerta de enlace IPFS y, opcionalmente, guardarlo localmente

Ejemplos de indicaciones para Claude

A continuación se muestran algunos ejemplos de cómo indicarle a Claude que utilice pinata-mcp:

Upload an image to Pinata:
"Please upload the file at ~/Pictures/example.jpg to my Pinata account as a private file named 'My Example Image'"

Search for files:
"Search my Pinata account for all PNG files"

Create a group and add files:
"Create a new group called 'Project Assets' on Pinata, then find all my JSON files and add them to this group"

Download content from IPFS:
"Fetch the content with CID QmX... from IPFS and save it to my Downloads folder"