Pixeldrain

pd（Pixeldrain CLI 和 MCP 服务）

pd 是面向 Pixeldrain 的命令行界面、Model Context Protocol（MCP）服务和 Go SDK。

它让你无需打开浏览器，即可直接从终端、Shell 脚本和 AI 工作流中轻松上传、下载和分享文件或相册。

功能

• 快速分享文件和媒体：从命令行上传文件，立即获取可分享的 Pixeldrain 链接。适合在聊天和论坛中分享 AI 生成的图像、屏幕截图或输出内容。
• AI 和 MCP 集成：内置 MCP 服务（pd mcp），可让 AI 工具（例如 Claude Desktop 和 Cursor）代你上传和下载文件。
• 相册支持：使用 --album 将多个文件合并到同一个 Pixeldrain 相册 URL 中。
• 端到端加密：上传前，使用 age 或 SSH 公钥在客户端加密文件。
• 适用于 Unix 管道：直接通过 stdin 管道传输数据，或使用 tar 流式传输整个目录。
• 可选的账号绑定：默认可匿名使用，也可以使用你的 Pixeldrain API 密钥 将文件归类到你的账号中。

快速开始

上传文件和媒体

将任意文件上传到 Pixeldrain 并获取下载链接：

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

你也可以使用 path:name 语法指定自定义显示名称：

pd upload output_0042.png:cyberpunk-city.png

创建相册

传入多个文件，将它们归为一个相册。这特别适合整理生成的图像或屏幕截图：

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 Agent 直接向 Pixeldrain 上传文本、图像和文件。

通过以下命令启动服务：

pd mcp

配置（Claude Desktop / Cursor）

将 pixeldrain 添加到你的 MCP 配置中（例如 claude_desktop_config.json）：

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

说明

PIXELDRAIN_API_KEY 为可选项。若已配置，AI Agent 上传的文件将归属于你的 Pixeldrain 账号。

可用的 MCP 工具：

• upload_files：上传一个或多个文件（图像、音频、压缩包），并返回文件或相册 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

可在 pixeldrain.com/user/api_keys 生成 API 密钥。

安装

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 客户端库。

请参阅 pkg.go.dev 上的包文档，了解 API 参考和用法示例。

许可证

本软件基于 MIT License 发布。