Pinata MCP

🚀 使用 Pinata 的模型上下文协议（MCP）服务器

本项目借助 Pinata 的模型上下文协议（MCP）服务器，让 Claude 具备访问公共和私有 IPFS 的能力。通过此集成，Claude 能够借助 Pinata 的 API 与公共和私有 IPFS 进行交互。

🚀 快速开始

使用本项目，可让 Claude 实现对公共和私有 IPFS 的访问。在完成安装配置后，即可启动 Claude 开始使用相关功能。

📦 安装指南

先决条件

• 已安装 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 删除文件：可删除 Pinata 中的文件。

组操作

• 列出组别：可列出组别，且带有可选筛选功能。
• 创建新的组别：用于组织文件。
• 获取组别详情：通过 ID 获取组别详情。
• 更新组信息：可更新组的相关信息。
• 删除组别：可删除指定组别。
• 添加/移除文件：可将文件添加到组别中或从组别中移除。

内容访问

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

高级用法

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

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

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

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

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

📚 常见问题

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