Pinata MCP

🚀 pinata - mcp

這是一個為Claude訪問Pinata提供支持的模型上下文協議（MCP）服務器。藉助此集成，Claude能夠通過Pinata的API與公共和私有IPFS進行交互，讓數據的管理和訪問更加便捷。

🚀 快速開始

在完成安裝步驟後，啟動Claude Code或打開Claude Desktop，即可開始使用pinata - mcp進行文件操作、組操作和內容訪問等功能。

📦 安裝指南

先決條件

• 已安裝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查詢組信息。
• 更新組資料：對組的資料進行更新。
• 刪除組別：刪除指定的組別。
• 添加/移除文件：將文件添加或移除到指定組別中。

內容訪問

• 生成私有下載鏈接：以訪問私人文件。
• 從IPFS網關獲取內容：可選擇將內容本地保存。

高級用法

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

上傳圖片至Pinata:
“請將~/Pictures/example.jpg文件上傳到我的Pinata賬戶，作為私有文件命名為'我的示例圖片'”

搜索文件:
“在我的Pinata賬戶中查找所有PNG格式的文件”

創建組別並添加文件:
“在Pinata上新建一個名為'項目資產'的組別，然後找到所有的JSON文件並將它們加入該組別”

從IPFS獲取內容:
“提取CID為QmX...的IPFS內容，並將其保存到我的下載文件夾中”

📚 詳細文檔

如遇任何問題，請發送郵件至此處與我們聯繫！