MIT License
3
最近更新:11个月前

为Claude提供访问Pinata API的能力,使其能够与公共和私有IPFS交互,实现文件上传、搜索、组织及内容检索功能。

pinata-mcp

一个为Claude提供Pinata访问权限的模型上下文协议(MCP)服务器。该集成允许Claude通过Pinata的API与公共和私有IPFS进行交互。

安装设置

前置要求

  • 已安装Node.js 18+版本
  • 拥有API密钥(JWT)的Pinata账户

安装步骤

安装方式取决于您使用的是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

json 复制代码
{
  "mcpServers": {
    "pinata": {
      "command": "npx",
      "args": [
        "pinata-mcp",
        "/允许访问的目录路径"
      ],
      "env": {
        "PINATA_JWT": "<您的JWT>",
        "GATEWAY_URL": "example.mypinata.cloud"
      }
    }
  }
}

使用说明

通过命令claude启动Claude Code或启动Claude Desktop即可开始使用MCP。以下是可用的操作:

文件操作

  • 将文件上传至Pinata(公共或私有IPFS)
  • 按名称、CID或mime类型搜索文件
  • 通过ID获取文件详情
  • 更新文件元数据(包括名称和键值对)
  • 从Pinata删除文件

分组操作

  • 列出分组(可选过滤条件)
  • 创建文件组织分组
  • 通过ID获取分组详情
  • 更新分组信息
  • 删除分组
  • 向分组添加/移除文件

内容访问

  • 创建私有下载链接以访问私有文件
  • 从IPFS网关获取内容并可选择本地保存

Claude使用示例

以下是指导Claude使用pinata-mcp的示例指令:

复制代码
上传图片到Pinata:
"请将位于~/Pictures/example.jpg的文件以'我的示例图片'为名作为私有文件上传到我的Pinata账户"

搜索文件:
"在我的Pinata账户中搜索所有PNG文件"

创建分组并添加文件:
"在Pinata上创建名为'项目资源'的新分组,然后找到我所有的JSON文件并添加到该分组"

从IPFS下载内容:
"从IPFS获取CID为QmX...的内容并保存到我的下载文件夹"

问题反馈

如有任何问题,请发送邮件至steve@pinata.cloud联系我们!