AppScreen

@appscreen/mcp

用于 AppScreen 的 MCP 服务——可通过任何支持 MCP 的 Agent（Claude Desktop、Claude Code、Cursor、Codex 等）生成 App Store / Play Store 截图。

安装

# Latest, no install — recommended for end users
npx -y @appscreen/mcp

配置（Claude Desktop）

~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "appscreen": {
      "command": "npx",
      "args": ["-y", "@appscreen/mcp"],
      "env": {
        "APPSCREEN_API_KEY": "mcm_live_…"
      }
    }
  }
}

匿名使用时可省略 APPSCREEN_API_KEY（终身可渲染 5 次，之后需要注册）。

配置（其他客户端）

• Claude Code： claude mcp add appscreen -- npx -y @appscreen/mcp

• Cursor： .cursor/mcp.json —— JSON 结构与上方相同。

• Codex： codex mcp add appscreen -- npx -y @appscreen/mcp，或添加到 ~/.codex/config.toml：

  [mcp_servers.appscreen]
  command = "npx"
  args = ["-y", "@appscreen/mcp"]
  env = { APPSCREEN_API_KEY = "mcm_live_…" }
  

工具

• render_screenshots —— 接受屏幕（布局 JSON）和图像文件。返回 jobId（密钥模式／异步）或下载链接（匿名／内联）。匿名免费使用最多可渲染 5 次。
• get_render_status —— 轮询 jobId。完成后返回状态和签名下载 URL。

通过路径传递图像，而不是 base64

服务在本地运行，因此请提供文件路径——服务会从磁盘读取字节。请勿在调用中将真实截图编码为 base64：LLM 输出 18k–90k 个字符的 base64 字符串时，中途可能丢失一个字符，导致其后部分的 PNG 渲染为黑色。

"files": [
  { "name": "1.png", "path": "~/app/screenshots/home.png" },   // ✅ preferred
  { "name": "2.png", "path": "/abs/path/settings.png" }
]
// base64 is accepted only for tiny synthetic test images:
// { "name": "x.png", "base64": "iVBORw0KG..." }

套图下载 URL 带有签名，约 1 小时后过期。重新轮询即可刷新。

配额

已登录用户的用量按积分计量：1 积分 = 1 张导出图像（屏幕数 × 尺寸数 × 语言数）。导出失败会退还积分；自动翻译免费。MCP 密钥消耗其创建所在工作区的积分。

方案	积分 / 月	说明
Free	50	每次导出可选任意一种尺寸，英语，每次导出最多 10 个屏幕。每小时最多渲染 3 次。
Starter — $4 / mo	400	支持全部 5 种尺寸，每次导出可选任意 3 种语言，支持自动翻译。每小时最多渲染 3 次。
Pro — $8 / mo	2,500	支持全部 15 种语言，每次导出最多 200 个屏幕。MCP 按完整速率计费。
Team — $29 / mo	8,000 pooled	包含 3 个席位。MCP 按完整速率计费。

一次性积分包适用于所有方案，包括 Free：100 积分 $5、400 积分 $15、1,500 积分 $39，有效期为 12 个月。匿名使用（无密钥）不按积分计量，终身最多可渲染 5 次。

每个工具响应都包含 _meta.quota = {used, cap, tier, resetAt}，以及 balance（剩余积分）；提交渲染时，如果 API 返回了 cost，响应中也会包含该字段。对于已登录的调用方，used 和 cap 统计的是积分（cap − used = balance），tier 是方案 ID；对于匿名调用方，它们统计的是 5 次终身渲染额度，tier 为 anon-mcp。剩余额度不足一半时，文本内容会显示简短提示（“剩余 N 积分……”）；低于 20% 或额度为零时，响应还会包含 _meta.upgradeUrl。

工作区积分不足以支付的导出会返回 HTTP 402 insufficient_credits——错误文本会说明费用和余额。详情请见：https://appscreen.co/pricing。

环境变量

变量	用途
APPSCREEN_API_KEY	可选。来自 https://appscreen.co/account/keys 的 MCP 密钥（mcm_live_…）。适用于所有方案，包括 Free。与程序化 ask_live_… API 密钥不同。
APPSCREEN_BASE_URL	覆盖 API URL。默认值为 https://api.appscreen.co。
APPSCREEN_MCP_CLIENT	覆盖客户端标识符（从 MCP initialize 自动检测）。

许可证

MIT