Pinata MCP

pinata-mcp是一个为Claude提供Pinata平台IPFS交互能力的MCP服务，支持文件上传、搜索、分组管理等操作。

云存储开发者工具 #IPFS管理 #文件存储 #Claude集成 .TypeScript

评分 : 2.5分

下载量 : 7.1K

更新时间 : 2025-04-14

打开站点

什么是 Pinata-MCP？

Pinata-MCP 是一个集成工具，它使您可以通过 Pinata 的 API 将文件上传到公有或私有 IPFS 网络。它还支持文件搜索、分组管理以及从 IPFS 网关获取内容等功能。

如何使用 Pinata-MCP？

首先需要安装 Node.js 18 或更高版本，并获取您的 Pinata API JWT 密钥。然后根据您的环境（Claude Code 或 Claude Desktop）进行配置。最后，您可以开始上传、下载或管理文件。

适用场景

Pinata-MCP 适用于需要高效管理分布式存储系统的用户，例如开发者、设计师或团队协作环境。

主要功能

上传文件

支持将文件上传至 Pinata 的公有或私有 IPFS 网络。

文件搜索

可以根据文件名、CID 或 MIME 类型来查找文件。

分组管理

创建、编辑和删除文件组，方便对文件进行分类和组织。

内容访问

生成私有下载链接或从 IPFS 网关获取文件。

优势

易于集成到现有工作流中。

支持多种文件操作，如上传、下载、搜索和管理。

确保文件的安全性和隐私性。

局限性

需要 Pinata API 密钥才能使用。

某些高级功能可能需要订阅特定计划。

如何使用

安装 Node.js

确保已安装 Node.js 18 或更高版本。

配置 Pinata API

获取您的 Pinata API JWT 密钥并将其添加到环境变量中。

添加 MCP 服务器

在 Claude Code 或 Claude Desktop 中添加 Pinata-MCP 配置。

使用案例

上传一张图片

将本地图片上传到 Pinata 并命名。

搜索文件

搜索所有名为 'report.pdf' 的文件。

创建分组

创建一个名为 'Assets' 的新分组并添加所有 JSON 文件。

常见问题

如何获取 Pinata API 密钥？

是否支持私有文件访问？

如果遇到问题怎么办？

🚀 项目说明：pinata - mcp

这是一个为Claude访问Pinata而提供的模型上下文协议（MCP）服务器。该集成让Claude能够借助Pinata的API与公共和私有IPFS进行交互，为用户在IPFS文件管理方面提供了便利。

🚀 快速开始

启动Claude Code或打开Claude Desktop后，就能开始使用pinata - mcp进行各类IPFS文件操作啦。

📦 安装指南

先决条件

已安装Node.js 18+版本
拥有一个Pinata账户及相应的API密钥（JWT）

安装步骤

根据您使用的是Claude Code还是Claude Desktop，安装方式有所不同。

Claude Code 运行claude mcp add并按照提示输入以下信息：

服务器名称: pinata
服务器范围: 项目或全局
服务器命令: npx
命令参数: pinata-mcp /指定的文件夹路径 /另一个指定的文件夹路径
环境变量: PINATA_JWT=<您的JWT密钥>, GATEWAY_URL=example.mypinata.cloud

Claude Desktop 将以下配置添加到claude_desktop_config.json文件中：

{
  "mcpServers": {
    "pinata": {
      "command": "npx",
      "args": [
        "pinata-mcp",
        "/指定的文件夹路径"
      ],
      "env": {
        "PINATA_JWT": "<您的JWT密钥>",
        "GATEWAY_URL": "example.mypinata.cloud"
      }
    }
  }
}

💻 使用示例

基础用法

启动Claude Code或打开Claude Desktop后，即可开展以下操作：

文件操作

上传文件：可将文件上传到Pinata（公共或私有IPFS）
搜索文件：能根据名称、CID或MIME类型搜索文件
获取文件详情：可通过ID查询文件详情
更新文件元数据：可以更新文件的名称和键值对等元数据
删除文件：能从Pinata中移除文件

组操作

列出组别：可选择过滤条件列出组别
创建新的组别：用于组织文件
获取组信息：可通过ID查询组信息
更新组资料
删除组别
添加/移除文件：可将文件添加或移除到指定组别中

内容访问

生成私有下载链接：可生成私有下载链接以访问私人文件
从IPFS网关获取内容：可选择将内容保存到本地

高级用法

以下是指导Claude使用pinata - mcp的一些示例：

上传图片至Pinata:
“请将~/Pictures/example.jpg文件上传到我的Pinata账户，作为私有文件命名为'我的示例图片'”

搜索文件:
“在我的Pinata账户中查找所有PNG格式的文件”

创建组别并添加文件:
“在Pinata上新建一个名为'项目资产'的组别，然后找到所有的JSON文件并将它们加入该组别”

从IPFS获取内容:
“提取CID为QmX...的IPFS内容，并将其保存到我的下载文件夹中”