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的文件上传到我的Pinata账户，作为名为'My Example Image'的私有文件"

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

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

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

常见问题

如果您遇到任何问题，请发送邮件至steve@pinata.cloud！