内容
# appstore-mockup-mcp
一款 MCP 服务器，能够将应用截图包裹在 iPhone 16 Pro 框架中，并在上方添加营销文本，生成适用于 App Store 的预览图像（1284×2778，适用于 App Store Connect 中的 6.5" 插槽）。
## 功能
- 将任意截图包裹在逼真的 iPhone 16 Pro 框架中（深色或银色）
- 在手机上方添加粗体标题 + 可选副标题
- 垂直渐变或纯色背景
- 批量模式 — 一次处理所有截图
- 主题建议来源于应用自身的颜色，并可自定义颜色覆盖
- 如果源图像已经是模拟图（防止手机套手机），则会发出警告
## 安装
```bash
uvx appstore-mockup-mcp
```
## 与 Claude Code 配合使用
在您的 `.mcp.json` 中添加：
```json
{
"mcpServers": {
"appstore-mockup": {
"command": "uvx",
"args": ["appstore-mockup-mcp"]
}
}
}
```
然后在 Claude Code 中，只需分享您的截图并询问：
> “为这些截图创建 App Store 模拟图”
Claude 会要求您选择主题，建议标题，获取您的批准，然后渲染所有内容。
## 工具
### `create_iphone_mockup`
单个截图 → 模拟图。
| 参数 | 默认值 | 描述 |
|-------|---------|-------------|
| `screenshot` | 必需 | 源 PNG/JPG 的绝对路径 |
| `title` | 必需 | 手机上方的标题 |
| `out` | 必需 | 输出路径 |
| `frame` | `silver` | `silver` 或 `dark` |
| `bg_color` | `#f5f1ea` | 十六进制或 `#hex1,#hex2` 表示渐变 |
| `text_color` | `#111111` | 十六进制 |
| `subtitle` | `""` | 标题下方的较小的行 |
| `size` | `1284x2778` | 输出尺寸 |
| `bleed` | `false` | 手机从底部边缘溢出 |
| `add_frame` | `true` | 如果源已经有手机框架，则设置为 `false` |
### `create_iphone_mockups_batch`
与 `create_iphone_mockup` 相同的参数，加上 `jobs` 列表和 `output_dir`。每个任务都可以覆盖任何批量级别的默认值。
### `suggest_themes`
获取截图路径列表，并返回源自应用自身颜色的主题建议（JSON 列表，包含 `{name, bg_color, text_color, frame, why}`）。
## 动态主题
主题源自应用自身的颜色，而不是固定的预设。`suggest_themes` 工具分析截图的主要背景和强调色，并建议：
| 名称 | 来源 | 外观 |
|------|-----------|------|
| 应用匹配 | 应用的主要背景，调整以适应手机对比度 | 原生、协调 |
| 品牌渐变 | 应用的强调色，从浅到深 | 强烈、品牌向前 |
| 软色调 | 强调色逐渐变为白色 | 清洁、简约 |
文本颜色和框架会自动选择以确保对比度。Claude 呈现建议，并始终提供自定义选项 — 如果您不喜欢任何建议，可以提供您自己的 `bg_color`（单个十六进制或 `#hex1,#hex2` 渐变）、`text_color` 和 `frame`。
## 许可证
MIT
