Pinata MCP

🚀 pinata - mcp

このプロジェクトは、ClaudeがPinataにアクセスするためのモデルコンテキストプロトコル（MCP）サーバーを提供します。この統合により、ClaudeはPinataのAPIを通じて、パブリックおよびプライベートなIPFSと相互作用することができます。

🚀 クイックスタート

このサーバーをインストールし、Claude CodeまたはClaude Desktopを起動すると、ClaudeがPinataのAPIを通じてIPFSと相互作用できるようになります。

✨ 主な機能

• ファイル操作：Pinata（パブリックまたはプライベートIPFS）へのファイルのアップロード、名前、CIDまたはMIMEタイプによるファイルの検索、IDによるファイル詳細の取得、名前やキーバリューペアを含むファイルメタデータの更新、Pinataからのファイルの削除が可能です。
• グループ操作：オプションのフィルタ条件でのグループの一覧表示、ファイルを整理するための新しいグループの作成、IDによるグループ情報の取得、グループ情報の更新、グループの削除、指定されたグループへのファイルの追加または削除ができます。
• コンテンツアクセス：プライベートファイルにアクセスするためのプライベートダウンロードリンクの生成、IPFSゲートウェイからのコンテンツの取得（オプションでローカルに保存）が可能です。

📦 インストール

前提条件

• 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ゲートウェイからのコンテンツ取得：IPFSゲートウェイからコンテンツを取得し、オプションでローカルに保存します。

高度な使用法

Claudeにpinata - mcpを使用するためのいくつかの例を以下に示します。

Pinataに画像をアップロードする:
“~/Pictures/example.jpg ファイルを、'私のサンプル画像'という名前のプライベートファイルとして、私のPinataアカウントにアップロードしてください”

ファイルを検索する:
“私のPinataアカウント内で、すべてのPNG形式のファイルを検索してください”

グループを作成してファイルを追加する:
“Pinata上に'プロジェクトアセット'という名前のグループを新規作成し、すべてのJSONファイルを見つけてそのグループに追加してください”

IPFSからコンテンツを取得する:
“CIDがQmX...のIPFSコンテンツを抽出し、私のダウンロードフォルダに保存してください”

📚 ドキュメント

問い合わせ先

何か問題がある場合は、こちらまでメールでご連絡ください！