内容
-mcp
本地MCP服务器，封装了 [Imagcon](https://imagcon.app) 的API，以便助手可以生成PWA图标集（所有尺寸、可遮罩资产、`manifest.json`）和iOS启动画面，无需打开网站。通过`uvx`作为标准输入/输出进程运行 — 无需托管服务依赖，无需持久连接。
## 要求
- Python 3.11–3
- [uv](https://docs.astral.sh/uv/) （提供`uvx`）
- Imagcon API密钥，以`ic_live，从 [imagcon.app/api-keys](https://imagcon.app/api 获取
## 安装
该软件包是自行托管的（不在上）。直接从轮文件安装：
```bash
claude mcp add imagcon -- uvx --from https://imagcon.app/downloads_mcp-0.2.4-py3-none-any.whl imagcon-mcp --api-key ic_live_...
```
或者，将密钥放在环境，而不是在命令行中：
```bash
claude mcp add -- uvx --from https://imagcon.app/downloads/imagcon-0.2.4-py3-none-any.whl imagcon-mcp
```
```bash
export IMAGCON_API_KEY=ic_live_...
```
对于其他MCP客户端（Cursor、Windsurf、VS Code、Cline、Zed、Warp、Continue.dev），请使用等效的标准输入/输出配置：
```json
{
"mcpServers": {
"imagcon": {
"command": "uvx",
"args": ["--from", "https://imagcon.app/downloads/imagcon_mcp-0.2.4-py3-none-any.whl", "imagcon-mcp", "--api-key", "ic_live_..."]
}
}
}
```
每个客户端的配置文件位置和完整示例：请参imagcon.app/.well-known/blueprint.txt](https://imagcon.app/.well-known/blueprint.txt) 中的CLIENT-CONFIGS。
##
**图像**
- **`生成图像`** — 根据文本描述AI生成源图像。返回`image_key`和预览URL。向用户显示在生成图标之前确认。
- **`保存图像`** — 通过`image_key`和`name`将生成的图像保存到您的图库中。
- **`列出已保存的图像`** — 列出所有已保存的源图像及其键和预览URL。
- **`从键生成图标`** — 从已保存的`image_key`生成完整的PWA图标集 — 无需重新生成，无需上传。与`生成PWA图标`的输出相同。
**图标集**
- **`生成PWA图标`** — AI生成源图像，然后调整为所有PWA尺寸，保存图标集，下载ZIP，解压到`output_dir`（默认为`./public/icons`）。
- **`从图像创建PWA图标`** — 从现有的本地PNG/JPEG/WebP文件`image_path`生成PWA图标（无需）。
- **`列出已保存的图标集`** — 列出已保存的图标集及其ID。
- **`下载图标集`** — 下载已保存的图标集ZIP文件，解压到`output_dir`。
- **`获取图标集下载URL`** — 获取已保存图标集ZIP文件的认证下载URL。
**启动画面**
- **`生成启动画面`** — AI生成源图像并生成16个iOS启动画面，解压到`output_dir`（默认为`./public/splash`）。
- **`从图像创建启动画面`** — 从现有的本地PNG/JPEG/WebP文件`image_path`生成启动画面（无需AI生成）。
- **`下载启动画面`** — 下载已保存的启动画面ZIP文件，解压到`output_dir`。
- **`获取启动画面下载URL`**保存启动画面ZIP文件的认证下载URL。
**账户 **`获取信用余额`**剩余的Imagcon积分。
AI图像生成（`生成图像`、`生成PWA图标`、`生成启动画面`）和图标/启动画面导出使用积分。`从图像创建PWA图标`、`从图像创建启动画面`和`从键生成图标`跳过AI生成积分，但仍需支付导出费用。
## 配置
| 来源 | 变量/标志 |
|--------|------------------|
| 环境变量 | `IMAGCON_API_KEY` |
| 命令行 | `--api-key`（覆盖环境变量） |
如果缺少密钥，进程将退出并显示错误，指向 [imagcon.app/api-keys](https://imagcon.app/api-keys)。
## API基准URL
所有请求均发送到 `https://imagcon.app`（不支持其他基准URL）。
