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 內容，並將其保存到我的下載文件夾"

📚 常見問題

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