StoreShots

StoreShots MCP

在 Cursor、Claude 或任何其他 MCP 客户端中，将原始应用截图转换为精美的 App Store 和 Google Play 营销截图。

这是一个小型 stdio MCP 服务，可与托管的 StoreShots API 通信。渲染在服务端进行，因此你的电脑上无需安装 Chrome、Puppeteer 或设计工具。给你的 Agent 几张截图和一些标题，它就会将适用于应用商店的 PNG（或 ZIP）保存到你的项目中。

• 每组 1–5 张截图，可来自本地文件或 URL
• 5 种精选风格：glow、midnight、sunset、mint、trailing，以及自定义颜色
• 设备边框：iphone、iphone-duo、android、ipad
• 一次调用生成所有必需的应用商店尺寸：ios-6.9（1320×2868）、ios-6.5（1242×2688）、android-phone（1080×1920）、ipad-13（2064×2752）
• 为每张幻灯片设置标题和说明文字
• 直接将 ZIP 和/或 PNG 下载到你的项目中

快速开始

1. 获取免费 API 密钥

使用电子邮件在 https://storeshots.qaimos.co.uk/account.html 注册。密钥（ss_...）只会显示一次，请将其妥善保存。

2. 将服务添加到 MCP 客户端

Cursor：将以下内容添加到 ~/.cursor/mcp.json（或项目中的 .cursor/mcp.json）。你也可以使用上方的“Install in Cursor”按钮。

{
  "mcpServers": {
    "storeshots": {
      "command": "npx",
      "args": ["-y", "storeshots-api-mcp"],
      "env": { "STORESHOTS_API_KEY": "ss_your_key_here" }
    }
  }
}

Claude Desktop：打开 Settings → Developer → Edit Config，然后将相同的配置块添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "storeshots": {
      "command": "npx",
      "args": ["-y", "storeshots-api-mcp"],
      "env": { "STORESHOTS_API_KEY": "ss_your_key_here" }
    }
  }
}

Claude Code：

claude mcp add storeshots --env STORESHOTS_API_KEY=ss_your_key_here -- npx -y storeshots-api-mcp

VS Code、Windsurf 和其他客户端：设置环境变量 STORESHOTS_API_KEY，然后通过 stdio 运行 npx -y storeshots-api-mcp。

需要 Node.js 18.17 或更高版本。

3. 向你的 Agent 提出请求

使用午夜风格，从 ./shots/home.png 和 ./shots/stats.png 生成 App Store 截图，标题分别为“养成持之以恒的习惯”和“查看你的进度”，并保存到 ./store-assets。

工具

工具	功能
list_styles	列出可用风格及其颜色和布局
list_devices	列出设备边框和应用商店输出尺寸
generate_screenshots	使用 screenshots（1–5 个路径或 URL）渲染一组截图。可选输入：style、device、targets[]、headlines[]、captions[]、appName、theme（颜色覆盖）、download_to 和 download_format（zip | png | both）。返回 jobId
get_output	将任务的 ZIP 和/或 PNG 下载到 output_dir。输出文件会保留 24 小时
get_balance	显示你的付费点数、本月剩余免费生成次数以及可用的点数包
buy_credits	返回点数包的 Stripe Payment Link，你可以在浏览器中打开。该工具本身绝不会向你收费

配置

变量	必填	默认值
STORESHOTS_API_KEY	是	无。可在 account.html 免费获取密钥
STORESHOTS_API_URL	否	https://storeshots.qaimos.co.uk/api.php
STORESHOTS_OUTPUT_DIR	否	~/StoreShots（默认下载文件夹）
STORESHOTS_TIMEOUT_MS	否	300000

定价

• 免费版：每月 3 组，带有小型“Made with StoreShots”水印
• 入门版：3 美元购买 10 组，无水印
• 专业版：5 美元购买 20 组，无水印

每组对应一次 generate_screenshots 调用，并包含你请求的所有尺寸。你可以通过 buy_credits 或在 storeshots.qaimos.co.uk 购买。

隐私

截图会通过 HTTPS 上传到 StoreShots API，在那里进行渲染，并在 24 小时后删除。你的 API 密钥会作为 X-API-Key 请求头发送。

开发

npm install
npm run inspect   # opens the MCP Inspector against src/index.js

npm test 会针对 StoreShots PHP API 的本地副本运行端到端测试，该 API 不属于此代码库。

链接

• 网站：https://storeshots.qaimos.co.uk/
• npm：https://www.npmjs.com/package/storeshots-api-mcp
• MCP Registry：uk.co.qaimos.storeshots/storeshots
• 问题反馈：https://github.com/qaimos/storeshots-mcp/issues

许可证

MIT