Pixeldrain

pd（Pixeldrain CLI & MCP Server）

pdは、Pixeldrain用のコマンドラインインターフェイス、Model Context Protocol（MCP）サーバー、およびGo SDKです。

ブラウザーを開かずに、ターミナル、シェルスクリプト、AI ワークフローからファイルやアルバムを直接アップロード、ダウンロード、共有できます。

機能

• ファイルとメディアをすばやく共有：コマンドラインからファイルをアップロードすると、すぐに共有可能なPixeldrainリンクを取得できます。AI が生成した画像、スクリーンショット、出力結果をチャットやフォーラムで共有するのに便利です。
• AI と MCP の統合：組み込みのMCPサーバー（pd mcp）により、Claude DesktopやCursorなどのAIツールから、ユーザーに代わってファイルをアップロード、ダウンロードできます。
• アルバムのサポート：--albumを使って、複数のファイルを1つのPixeldrainアルバムURLにまとめられます。
• エンドツーエンド暗号化：ageまたはSSH公開鍵を使って、アップロード前にクライアント側でファイルを暗号化できます。
• Unixパイプラインに対応：stdinからデータを直接パイプしたり、tarでディレクトリ全体をストリーミングしたりできます。
• 任意のアカウント紐付け：匿名でそのまま利用することも、Pixeldrain API keyを使ってアカウント内のファイルを整理することもできます。

クイックスタート

ファイルとメディアをアップロード

任意のファイルをPixeldrainにアップロードして、ダウンロードリンクを取得します。

pd upload artwork.png
# => https://pixeldrain.com/u/xxxxxx

path:name構文を使って、任意の表示名を指定することもできます。

pd upload output_0042.png:cyberpunk-city.png

アルバムを作成

複数のファイルを渡すと、1つのアルバムにまとめられます。生成した画像やスクリーンショットをまとめる場合に特に便利です。

pd upload --album "Neon Dreams" concept1.png concept2.png concept3.png
# => https://pixeldrain.com/l/xxxxxx

ファイルとアルバムをダウンロード

ファイルをローカル環境にダウンロードします。

# Download a single file (saved to current directory by default)
pd download https://pixeldrain.com/u/xxxxxx

# Download all files from an album without interactive prompts
pd download --all https://pixeldrain.com/l/xxxxxx

# Specify destination directory or filename
pd download -o ./downloads https://pixeldrain.com/u/xxxxxx
pd download --filename custom.png https://pixeldrain.com/u/xxxxxx

MCP サーバー（AI 統合）

pdには組み込みのModel Context Protocol（MCP）サーバーがあり、AI エージェントからテキスト、画像、ファイルをPixeldrainに直接アップロードできます。

次のコマンドでサーバーを起動します。

pd mcp

設定（Claude Desktop / Cursor）

MCPの設定（例：claude_desktop_config.json）にpixeldrainを追加します。

{
  "mcpServers": {
    "pixeldrain": {
      "command": "pd",
      "args": ["mcp"],
      "env": {
        "PIXELDRAIN_API_KEY": "your_api_key_here"
      }
    }
  }
}

メモ

PIXELDRAIN_API_KEYの設定は任意です。設定すると、AI エージェントがアップロードしたファイルはPixeldrainアカウントに紐付けられます。

利用可能なMCPツール：

• upload_files：1つ以上のファイル（画像、音声、アーカイブ）をアップロードし、ファイルまたはアルバムのURLを返します。各ファイルには{name, data}を指定します。dataにはローカルファイルのパス、Base64、またはBase64データURIを指定できます。
• upload_text：プレーンテキストまたはMarkdownをファイルとしてアップロードし、ダウンロードURLを返します。
• download_file：Pixeldrainからローカルマシンにファイルをダウンロードします。

高度な使い方

STDINからアップロード（ログ、差分、パイプライン）

標準入力からデータをアップロードするには、パスとして-を指定します（-がフラグとして扱われないよう、先頭に--を付けてください）。

# Upload command output or logs
cat build.log | pd upload -- -:build.log

# Upload a git diff
git diff | pd upload -- -:patch.diff

ディレクトリをアップロード

ディスク上に一時ファイルを作成せず、ディレクトリアーカイブを直接ストリーミングしてアップロードします。

tar zcf - ~/Projects/my-app | pd upload -- -:my-app.tar.gz

エンドツーエンド暗号化（E2EE）

ageまたはSSH公開鍵を使って、アップロード前にファイルをローカルで暗号化します。

# Encrypt with an age public key or SSH key
pd upload --recipient "age1..." secret.pdf
pd upload --recipient "ssh-ed25519 AAAA..." secret.pdf

# Encrypt for multiple recipients using a file
pd upload --recipient-file recipients.txt secret.pdf

（アップロードしたファイルには、自動的に.age拡張子が付与されます。）

ダウンロード時に復号するには、--identityで秘密鍵を指定します。

pd download --identity ~/.ssh/id_ed25519 https://pixeldrain.com/u/xxxxxx

アカウント認証

アップロードを Pixeldrain アカウントに関連付けるには、--api-key フラグまたは PIXELDRAIN_API_KEY 環境変数を使って API キーを指定します。

export PIXELDRAIN_API_KEY="your-api-key"
pd upload file.zip

# Or via command flag:
pd --api-key "your-api-key" upload file.zip

API キーは pixeldrain.com/user/api_keys で生成できます。

インストール

Homebrew（macOS と Linux）

brew tap jkawamoto/pixeldrain
brew install pixeldrain

Go のインストール

go install github.com/jkawamoto/go-pixeldrain/cmd/pd@latest

ビルド済みバイナリ

macOS、Linux、Windows 用のコンパイル済みバイナリは、GitHub Releases から入手できます。

Go ライブラリの使用方法

go-pixeldrain は、Pixeldrain REST API 用の Go クライアントライブラリも提供しています。

API リファレンスと使用例については、pkg.go.dev のパッケージドキュメントをご覧ください。

ライセンス

このソフトウェアは、MIT License の下で公開されています。