使用 Pinata 的模型上下文协议（MCP）服务器，为 Claude 提供访问公共和私有 IPFS 的能力。此集成允许 Claude 通过 Pinata 的 API 与公共和私有 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
• 更新组信息
• 删除组别
• 添加/移除文件到/from 组别中

内容访问

• 生成私人下载链接用于访问私有文件
• 从 IPFS 门路获取内容并可选本地保存

示例提示（供 Claude 使用）

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

上传图片到 Pinata:
"请将 ~/Pictures/example.jpg 文件上传到我的 Pinata 账户，作为私有文件命名为 'My Example Image'"

搜索文件:
"在 Pinata 中搜索所有 PNG 格式的文件"

创建组别并添加文件:
"在 Pinata 上创建一个新的名为 'Project Assets' 的组别，然后找到所有 JSON 文件并将它们添加到该组中"

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

常见问题

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