pinata-mcp

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

设置

前提条件

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

安装

安装方式取决于您使用的是 Claude Code 还是 Claude Desktop

Claude Code

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

服务器名称: pinata
服务器范围: 项目或全局
服务器命令: npx
命令参数: pinata-mcp /path/to/allowed/directories /another/path/to/allowed/directories
环境变量: PINATA_JWT=<YOUR_JWT>,GATEWAY_URL=example.mypinata.cloud

Claude Desktop

将以下配置添加到 claude_desktop_config.json

{
  "mcpServers": {
    "pinata": {
      "command": "npx",
      "args": [
        "pinata-mcp",
        "/path/to/allowed/directory"
      ],
      "env": {
        "PINATA_JWT": "<YOUR_JWT>",
        "GATEWAY_URL": "example.mypinata.cloud"
      }
    }
  }
}

用法

要开始使用 MCP，请使用命令 claude 启动 Claude Code 或启动 Claude Desktop。 以下是可用的操作：

文件操作

• 上传文件到 Pinata（公共或私有 IPFS）
• 按名称、CID 或 MIME 类型搜索文件
• 按 ID 获取文件详细信息
• 更新文件元数据，包括名称和键值对
• 从 Pinata 删除文件

群组操作

• 列出群组，可选择过滤
• 创建群组以组织文件
• 按 ID 获取群组详细信息
• 更新群组信息
• 删除群组
• 将文件添加/删除到/从群组

内容访问

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

Claude 的示例提示

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

将图像上传到 Pinata：
"请将 ~/Pictures/example.jpg 的文件作为名为 'My Example Image' 的私有文件上传到我的 Pinata 帐户"

搜索文件：
"在我的 Pinata 帐户中搜索所有 PNG 文件"

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

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

问题

如果您遇到任何问题，请发送 电子邮件 给我们！