金大哥 - Pinata MCP MCP 详情

article

README

🚀 项目说明：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内容，并将其保存到我的下载文件夹中”

📄 联系我们

如遇任何问题，请发送邮件至此处与我们联系！

Pinata MCP