mcp-mockuuups

用于 Mockuuups Studio 的 MCP 服务器 — 搜索约 5,300 个设备和印刷品样机，然后将截图或你自己的图片渲染到其中。

一个设计 — WTDIB 柏林城市指南 — 从一次拍摄中渲染到四个样机里，这样场景保持不变，只有设备在变化。两次工具调用，无需任何图片托管。

为什么存在

Mockuuups 在 https://mcp.mockuuups.studio/mcp 提供他们自己托管的 MCP 服务器。它只暴露一个 generate_mockup 工具，需要你已经知道的样机 ID 和一个你已经托管在公开位置的图片。

这个服务器改为包装底层 REST API，并弥补了托管版在实际使用中令人尴尬的两个缺口：

• 你可以搜索。 上游目录端点完全不接受搜索参数 — q、type、family 和 tag 会被静默忽略，每个请求都返回相同的未过滤页面。整个目录只获取一次并在本地搜索，所以"桌上的平板"或"海报"真的能找到东西。

• 你可以上传。 Mockuuups 只从 URL 渲染。把原始图片字节交给这个服务器，它会将字节暂存到一个短时不可猜测的链接下供渲染器获取，因此本地设计不需要存储桶、不需要 CDN、也不需要托管。

渲染你本地持有的图片

Mockuuups 只从 URL 渲染。传入 image_base64，这个服务器会将字节暂存到一个短时不可猜测的链接下，让渲染器获取，然后让它过期 — 不需要存储桶、不需要 CDN、不需要托管账户。

上面的 iPad 渲染图，从磁盘上传并渲染到带框的 A3 海报中。

Related MCP server: Store Screenshot Generator MCP

工具

将一个设计渲染到多个设备上

一起拍摄的场景共享一个 tag，所以要在多个设备上获得一致外观的方法是先搜索一个，然后按它的 tag 过滤：

search_mockups(query="ipad", tag="update-august-2024-meeting-room")
create_mockups(
    mockup_ids=["Zkn1GMTfiAFX5ZOn", "Zkn2DsTfiAFX5ZPD", "Zkn15MTfiAFX5ZO_"],
    screenshot_url="https://wtdib.cdit-works.de/",
)

配置

参见 .env.example。两个重要的：

• MOCKUUUPS_API_KEY — 来自 mockuuups.studio/developers 的开发者密钥。

• PUBLIC_BASE_URL — 这个服务器的公开源。上传需要它，因为 Mockuuups 的渲染器会通过公共互联网取回暂存的图片。截图和图片 URL 渲染不需要它也能工作。

值得了解的套餐限制

API 按积分计费：一次渲染 = 1 积分，网站截图 +1，高清 +1。只有成功的渲染才收费。

有两个行为如果你不知道会踩坑：

• 省略 size 意味着高清，在任何没有该功能的套餐上都会以 feature-not-available 硬失败。这个服务器总是显式发送 size，上限由 MOCKUUUPS_MAX_SIZE（默认 1000，即 Trial 上限）控制。当账户拥有 hires 功能时可以提高它。

• 在带有 cdn-temporary 的套餐上，交付链接约 24 小时后过期。 下载任何值得保留的内容。account_status 会报告这一点。

开发

uv sync
uv run pytest
uv run mcp-mockuuups          # stdio
TRANSPORT=http uv run mcp-mockuuups   # streamable-http on /mcp

许可证

MIT