glassypic

@glassypic/mcp-server

GlassyPic の MCP サーバーです。画像をそのまま本番環境で使えるアセットに変換するツールを備えています。アップスケーリング、サイズ変更とトリミング、圧縮、ファイル形式の変換、SEO 向けのファイル名と代替テキストの生成に対応しています。希望する仕上がりを自然言語で説明してください。

クイックスタート

MCP クライアントの設定に追加します。

{
  "mcpServers": {
    "glassypic": {
      "command": "npx",
      "args": ["-y", "@glassypic/mcp-server@latest"]
    }
  }
}

サインアップは不要です。1 日あたり 20 クレジットを無料で、インストール後すぐに利用できます。

Windows ユーザーの方へ： JSON 設定を編集した後にサーバーが表示されない場合、クライアントが PATH から npx を解決できていない可能性があります（よくある、気付きにくい失敗です）。コマンドを cmd /c で囲んでください。

{
  "mcpServers": {
    "glassypic": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@glassypic/mcp-server@latest"]
    }
  }
}

これは以下の手動編集する JSON 設定（Claude Desktop、Cursor、Windsurf、Cline）に適用されます。CLI コマンド（Claude Code、Gemini CLI、Codex CLI）には影響しません。

クライアント別のセットアップ

{
  "mcpServers": {
    "glassypic": {
      "command": "npx",
      "args": ["-y", "@glassypic/mcp-server@latest"]
    }
  }
}

claude mcp add glassypic -- npx -y @glassypic/mcp-server@latest

{
  "mcpServers": {
    "glassypic": {
      "command": "npx",
      "args": ["-y", "@glassypic/mcp-server@latest"]
    }
  }
}

{
  "mcpServers": {
    "glassypic": {
      "command": "npx",
      "args": ["-y", "@glassypic/mcp-server@latest"]
    }
  }
}

{
  "mcpServers": {
    "glassypic": {
      "command": "npx",
      "args": ["-y", "@glassypic/mcp-server@latest"]
    }
  }
}

gemini mcp add --transport stdio glassypic npx -y @glassypic/mcp-server@latest

{
  "mcpServers": {
    "glassypic": {
      "command": "npx",
      "args": ["-y", "@glassypic/mcp-server@latest"]
    }
  }
}

codex mcp add glassypic -- npx -y @glassypic/mcp-server@latest

[mcp_servers.glassypic]
command = "npx"
args = ["-y", "@glassypic/mcp-server@latest"]

ツール：optimize_image

画像を入力として受け取り、固定のサーバーサイドパイプラインで本番環境向けのアセットに変換するツールです（通常、サイズを 60～80％削減）。オプションでサイズ変更、アップスケーリング、形式変換、SEO メタデータの生成にも対応しています。入力形式は JPEG、PNG、WebP、AVIF、GIF、SVG、ICO、HEIC、TIFF、BMP です。出力形式は JPEG、PNG、WebP、AVIF、GIF、SVG、ICO です。絶対ローカルファイルパスまたはリモート URL を受け付けます。

パラメーター

リサイズ動作

例

基本的な圧縮 — 圧縮のみを行い、形式と寸法を維持します。

{ "input": "/Users/me/photos/hero.png" }

WebP に変換：

{ "input": "/Users/me/hero.png", "output_format": "webp" }

比率を保ってリサイズ — 片方の寸法を指定すると、もう片方は比率に合わせて拡大縮小されます。

{ "input": "/Users/me/hero.png", "output_width_px": 1200 }

余白を付けて正確な寸法にする — 空いた部分を白い帯で埋めます。

{ "input": "/Users/me/hero.png", "output_width_px": 1080, "output_height_px": 1080 }

スマートクロップで正確な寸法にする：

{ "input": "/Users/me/hero.png", "output_width_px": 1080, "output_height_px": 1080, "output_resize_behavior": "crop" }

AI で 4 倍にアップスケール：

{ "input": "/Users/me/icon.png", "output_upscale_factor": 4 }

URL から取得してディレクトリに保存：

{ "input": "https://example.com/photo.jpg", "output_path": "/Users/me/assets/" }

クレジットを 1 つ節約するため SEO をスキップ：

{ "input": "/Users/me/hero.png", "output_seo_tag_gen": false }

出力

テキスト形式の概要と構造化メタデータを返します。

Optimized: /Users/me/photos/modern-office-workspace.webp
Size: 142.3 KB
Compression: 73%
Format: webp
Dimensions: 1920x1080
Alt text: Modern office workspace with laptop and coffee cup on wooden desk

構造化出力のフィールド：

{
  "output_path": "/Users/me/photos/modern-office-workspace.webp",
  "output_size_bytes": 145715,
  "output_width_px": 1920,
  "output_height_px": 1080,
  "output_format": "webp",
  "compression_ratio": 0.27,
  "seo_alt_text": "Modern office workspace with laptop and coffee cup on wooden desk",
  "seo_keywords": ["office", "workspace", "laptop", "desk", "modern"],
  "seo_filename": "modern-office-workspace"
}

対応形式

GlassyPic は、入力形式と出力形式のあらゆる組み合わせで高品質な変換に対応しています。 アニメーション GIF を GIF 以外の形式（JPG、PNG、WebP、AVIF）に変換すると、最初のフレームのみが保持されます。 アニメーション GIF 形式への変換では、アニメーションと画質を維持したままアップスケールやリサイズができます。出力フレーム数を減らして、アニメーション GIF のファイルサイズを小さくすることもできます。

アップロードできるファイルの最大サイズ：50 MB。

SVG と ICO の例

# Optimize an SVG file (keeps as vector)
Optimize logo.svg and keep it as SVG

# Convert SVG to raster
Convert icon.svg to a 512x512 PNG

# Trace raster to vector SVG
Convert my logo.png to a vector SVG

# Generate favicon set from any image
Convert logo.png to an ICO favicon

# Generate single-size ICO
Convert logo.png to a 32x32 ICO

# Extract largest icon from ICO
Convert favicon.ico to PNG

動作の仕組み

Local file or URL
  → Upload to GlassyPic API
    → Optional AI upscale (explicit, or automatic when a resize target exceeds the source by more than 1.2×)
    → Optional resize
    → Compression
    → Optional SEO metadata
  → Download optimized file
    → Save with the SEO filename slug, or a `.polished` suffix when SEO is off or returns no slug

すべての処理は GlassyPic API を介してサーバー側で行われます。MCP サーバーは、パイプラインを調整する軽量なクライアントです。

クレジット

ゲストはサインアップなしでツールを利用できます。ログインすると GlassyPic アカウントが連携され、そのクレジットをウェブアプリと共有します。利用可能なクレジット数はプランによって異なり、時間とともに変更されます。現在の残高は status ツールを実行して確認するか、プランについては glassypic.com/pricing をご覧ください。デフォルトの実行（圧縮 + SEO タグ生成）では、画像 1 枚につき 4 クレジットを消費します。

セッションデータは ~/.glassypic/session.json にローカル保存され、呼び出しの間も保持されます。

自動アップスケーリング

リサイズの目標サイズが元画像の1.2倍を超える場合、GlassyPicはリサイズ前にAIアップスケーリングを自動で実行するため、拡大してもぼやけず、鮮明な画像に仕上がります。これはoutput_upscale_factorを設定していなくても実行され、クレジットを2消費します。

そのため、元画像が目標サイズより小さい場合、リサイズのみの呼び出しでもフルパイプラインと同じコストがかかります。

アニメーションGIFはフレームごとに課金されます。confirm_gif_costパラメーターを参照してください。

アカウントとクレジット

ログインすると、追加のクレジットを利用でき、ウェブアプリとMCPサーバーで共有できます。

Use the login tool to sign in.
Use the status tool to check your current credits.
Use the upgrade tool to open the pricing page.
Use the logout tool to sign out.

ログイン

ブラウザーウィンドウを開き、ログインを完了します（Google、Facebook、またはメール／マジックリンク）。承認後、アカウントが連携され、クレジットがウェブアプリと共有されます。

Login complete: [email protected] (Pro tier, 3,150 of 3,300 credits remaining)

ステータス

一括処理の前に、現在のアカウントの状態とクレジットを確認します。

Logged in as [email protected] (Pro tier)
Credits: 3,150 of 3,300 remaining
Resets: 03/01/2026, 12:00 AM PST

ログアウト

セッションを無効にして、ゲストモードに戻ります。

アップグレード

ブラウザーでglassypic.com/pricingを開きます。

AI エージェント向けのヒント

エージェントがツールを効果的に使えるように、以下をCLAUDE.mdまたはシステムプロンプトに貼り付けてください。

## GlassyPic MCP

Tools: optimize_image, login, logout, status, upgrade

- Use status to check credits before batch processing
- Credits: 3 to compress (always), +1 if width/height is set, +2 to upscale, +1 for SEO tags (default). A full pipeline is 7 credits. SVG/ICO output is a flat 1 credit.
- Resizing up past 1.2x the source triggers an automatic AI upscale (+2 credits) even without output_upscale_factor set — a resize-only call on a small image can cost 7, not 5.
- Allowances vary by plan; call status for the live balance instead of assuming a number.
- Always use absolute file paths, not relative.
- Set only width OR height for proportional resize. Set both for exact dimensions.
- When both dimensions are set, use output_resize_behavior: "crop" for photos, "pad" for logos/icons.
- output_seo_tag_gen (default true) renames the file to an SEO slug and generates alt text + keywords.
- Set output_seo_tag_gen: false to save 1 credit when SEO metadata is not needed.
- GIF is supported for both input and output; animated GIFs stay animated when output_format is "gif".
- Converting an animated GIF to jpg/png/webp/avif preserves only the first frame.
- HEIC, TIFF, BMP inputs are auto-converted to JPG.
- For batch processing, call optimize_image once per file.
- If credits run out, use login to sign in or upgrade to open pricing.

トラブルシューティング

ツール一覧にサーバーが表示されない場合：

• 設定を編集した後、MCPクライアントを再起動してください
• Node.js >= 18がインストールされていることを確認してください：node --version
• 直接実行してみてください：npx -y @glassypic/mcp-server@latest（エラーなしで起動するはずです）
• **Windowsの場合：**サーバーが何も表示せず読み込まれない場合は、コマンドをcmd /cでラップしてください（"command": "cmd"、"args": ["/c", "npx", "-y", "@glassypic/mcp-server@latest"]）。クイックスタートのWindowsに関する注記を参照してください

「クレジットが不足しています」エラー：

• statusツールで残りのクレジットを確認してください
• loginツールでログインして、追加のクレジットを利用してください
• upgradeツールで料金ページを開き、プランを比較してください
• SEOタグを無効にすると（output_seo_tag_gen: false）、クレジットを1節約できます。ただし、元画像の1.2倍を超えて拡大する場合は、自動アップスケーリングでクレジットを2消費します

ログイン用のブラウザーウィンドウが開かない場合：

• 次のURLを手動で開き、ターミナルに表示されたコードを入力してください：https://glassypic.com/mcp/authorize
• ブラウザーがインストールされ、アクセス可能であることを確認してください

セッショントークンに関する問題：

• セッションデータは~/.glassypic/session.jsonに保存されています
• このファイルを削除すると、リセットして最初からやり直せます
• logoutを実行してからloginを実行し、再認証してください

ファイルが見つからない場合：

• ローカルファイルには絶対パスを使用してください
• URLの場合、画像が公開アクセス可能であることを確認してください

タイムアウトエラー：

• 大きな画像やAIアップスケーリングの処理には30〜60秒かかることがあります
• サーバーでは、ジョブごとに60秒のタイムアウトが設定されています

プライバシーポリシー

ポリシー全文：https://glassypic.com/privacy/

送信される情報。 最適化する画像は、認証トークンとともに GlassyPic API （https://api.glassypic.com）にアップロードされ、処理されます。画像はアカウントのプランに応じて保持された後、削除されます。元のアップロード画像と処理後の画像の両方が対象です。保持期間については、ポリシーをご覧ください。

リモート URL をツールに渡すと、GlassyPic API がサーバー側でその URL にアクセスします。URL 自体は GlassyPic に送信され、画像ホストへのリクエストはお使いのマシンではなく、GlassyPic のサーバーから行われます。

ローカルに保存される情報。 login ツールを使用すると、アクセストークンとアカウントのメールアドレスが、ファイルモード 0600（所有者のみ読み取り／書き込み可能）で ~/.glassypic/session.json に書き込まれます。ログインせずに画像を最適化した場合、初回のアップロードでゲストセッショントークンが発行され、同じゲストセッションのクレジットを以降の呼び出しでも使用できるよう、同じファイルに書き込まれます。このトークンには、アカウント、メールアドレス、個人情報は関連付けられません。 logout ツールを実行すると、ファイル内のトークンが削除されます。アカウントとクレジットおよびトラブルシューティングもご覧ください。

収集されない情報。 ローカルコネクターとして実行する場合、このサーバーはテレメトリーを送信せず、GlassyPic API 以外へのネットワーク呼び出しも行いません。（リモート HTTP トランスポートでは、認証のため Supabase も呼び出します。）

設定

値には https の URL を指定する必要があります。平文の http が許可されるのは localhost と 127.0.0.1 のみです。これは、画像と Bearer トークンがこのホストに送信されるためです。値が無効な場合、誤ったエンドポイントへのリクエストが黙って行われるのではなく、変数名を示す明確なエラーが表示されます。

要件

• Node.js >= 18
• MCP 対応クライアント（Claude Desktop、Claude Code、Cursor、Windsurf、Cline、OpenAI Codex CLI、Gemini CLI など）

セキュリティ

脆弱性は非公開で報告してください。SECURITY.mdをご覧ください。修正されていないセキュリティ報告について、公開の issue を作成しないでください。

ライセンス

MIT - LICENSEをご覧ください。