glassypic

@glassypic/mcp-server

适用于 GlassyPic 的 MCP 服务。只需一个工具，即可将原始图像转换为可用于生产的素材：放大、调整大小和裁剪、压缩、转换文件格式，以及生成 SEO 文件名和替代文本。用自然语言描述你想要的效果。

快速开始

将以下内容添加到 MCP 客户端配置中：

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

无需注册。开箱即用，每天可免费使用 20 次。

Windows 用户： 编辑 JSON 配置后，如果 MCP 服务未出现，客户端可能无法从 PATH 中解析 npx（这是一种常见且不会显示错误的故障）。请用 cmd /c 包装命令：

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

这适用于下方手动编辑的 JSON 配置（Claude Desktop、Cursor、Windsurf、Cline）。命令行命令（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/" }

跳过 SEO 以节省 1 个积分：

{ "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 格式时，支持放大或调整尺寸，同时保留动画和画质。也可以通过减少输出帧数来缩小动画 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 账户，并与 Web 应用共享积分。不同套餐的额度各不相同，也会随时间变化：运行 status 工具查看实时余额，或访问 glassypic.com/pricing 查看套餐。默认运行（压缩 + SEO 标签）每张图片消耗 4 个积分。

会话数据存储在本地的 ~/.glassypic/session.json 中，并会在多次调用之间保留。

自动放大

当调整尺寸的目标宽度或高度超过源图像的 1.2 倍时，GlassyPic 会在调整尺寸前自动进行 AI 放大，让放大后的图像保持清晰，而不是模糊。 即使未设置 output_upscale_factor，也会触发此功能，并且额外消耗 2 个额度。

因此，当源图像小于目标尺寸时，仅调整尺寸的调用费用与完整流程相同：

动画 GIF 按帧计费——请参阅 confirm_gif_cost 参数。

账户与额度

登录即可解锁更多额度，并在 Web 应用和 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 或电子邮件/魔法链接）。批准后，你的账户即会关联，并与 Web 应用共享额度。

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 Agent 的提示

将以下内容粘贴到 CLAUDE.md 或系统提示词中，帮助 Agent 有效使用此工具：

## 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 工具时，你的访问令牌和账户邮箱会写入 ~/.glassypic/session.json，文件权限模式为 0600 （仅所有者可读写）。如果你在未登录的情况下优化图像，首次上传时会生成一个访客会话令牌，并将其写入同一文件，以便后续调用继续使用同一访客会话的额度——该令牌不会关联任何账户、邮箱或个人信息。 运行 logout 工具会移除文件中的令牌。另请参阅 账户与额度和故障排除。

不会收集的内容。 作为本地连接器运行时，此服务不会发送遥测数据，除调用 GlassyPic API 外也不会进行其他网络请求。（远程 HTTP 传输还会调用 Supabase 进行身份验证。）

配置

此值必须是 https URL。仅当地址为 localhost 或 127.0.0.1 时才接受纯 http，因为你的图像和 Bearer 令牌会发送到此主机。值无效时会明确指出变量名称并报错，而不会在无提示的情况下向错误的端点发送请求。

要求

• Node.js >= 18
• 兼容 MCP 的客户端（Claude Desktop、Claude Code、Cursor、Windsurf、Cline、OpenAI Codex CLI、Gemini CLI 等）

安全

请私下报告漏洞。参见 SECURITY.md。对于尚未修复的安全问题，请勿公开提交问题。

许可证

MIT - 参见 LICENSE。