Pinata MCP

🚀 Pinataのモデルコンテキストプロトコル（MCP）サーバーを使用したClaudeとIPFSの統合

Pinataのモデルコンテキストプロトコル（MCP）サーバーを利用することで、Claudeに公共および私有のIPFSへのアクセス機能を提供します。この統合により、ClaudeはPinataのAPIを通じて公共および私有のIPFSと相互作用することができます。

🚀 クイックスタート

このガイドでは、PinataのMCPサーバーをClaudeと統合する方法を説明します。以下の手順に従って、Claudeで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ゲートウェイからコンテンツを取得 オプションでローカルに保存

高度な使用法

以下は、Claudeでpinata - mcpを使用するための例です。

Pinataに画像をアップロード:
"~/Pictures/example.jpg ファイルを私のPinataアカウントに私有ファイルとして 'My Example Image' という名前でアップロードしてください"

ファイルを検索:
"PinataですべてのPNG形式のファイルを検索してください"

グループを作成してファイルを追加:
"Pinata上に 'Project Assets' という名前の新しいグループを作成し、すべてのJSONファイルを見つけてそのグループに追加してください"

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

📚 ドキュメント

よくある質問

何か問題が発生した場合は、こちら までメールでお問い合わせください！