@avclabs.ai/media-mcp 0.2.1 → 0.3.0

package/README_CN.md

@@ -6,7 +6,9 @@
 [![Node.js >=18](https://img.shields.io/badge/node-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-基于 MCP 协议的视频增强与图像分割服务，作为 MCP Client-Server 与后端 HTTP Server 交互。
+基于 MCP 协议的视频增强、图片增强/上色/降噪与图像分割服务，作为 MCP Client-Server 与后端 HTTP Server 交互。
+
+> **发布状态**：当前 npm `latest`（`0.2.1`）包含 3 个视频工具和 2 个 SAM3 工具。图片增强工具正在积极开发中，将在后续版本发布——下文已提前列出供尝鲜参考，但目前尚不包含在已发布的 npm 包中。
 
 ## 功能
 
@@ -15,10 +17,17 @@
 **视频增强**
 - `create_task` - 创建视频增强任务（支持 URL 或本地文件上传）
 - `get_task_status` - 查询任务状态
-- `enhance_video_sync` - 同步增强视频（阻塞等待，默认50秒截断）
+- `enhance_video_sync` - 同步增强视频（阻塞等待，默认45秒截断）
+
+**图片增强（即将发布，暂不含于已发布的 npm 包）**
+- `enhance_image_sync` - 图片画质增强与人脸优化（支持 URL 或本地文件上传）
+- `colorize_image_sync` - 黑白照片上色（支持 URL 或本地文件上传）
+- `denoise_image_sync` - 图片降噪去噪（支持 URL 或本地文件上传）
+- `get_image_task_status` - 查询图片任务状态（同步工具超时后用于轮询）
 
 **图像分割 (SAM3)**
 - `sam3_predict` - SAM3 图像分割（支持本地路径、URL 或 Base64 图片）
+- `get_sam3_task_status` - 查询 SAM3 任务状态（同步工具超时后用于轮询）
 
 ## 前置要求
 
@@ -109,24 +118,28 @@ AI 会自动完成：
 重启客户端后，确认工具是否加载成功：
 
 1. 或直接问 AI："你有哪些可用的工具？"
-2. 应看到：`create_task`、`get_task_status`、`enhance_video_sync`、`sam3_predict`
+2. 当前 npm `latest=0.2.1` 应看到 `create_task`、`get_task_status`、`enhance_video_sync`、`sam3_predict`、`get_sam3_task_status`。
+3. 图片工具随后续版本发布后，还应能看到 `enhance_image_sync`、`colorize_image_sync`、`denoise_image_sync`、`get_image_task_status`。
 
 ## 配置项
 
 | 变量名 | 必填 | 默认值 | 说明 |
 |---|---|---|---|
-| `API_KEY` | **是** | - | API 认证密钥（视频增强和 SAM3 共用） |
-| `HTTP_API_BASE_URL` | 否 | `https://mcp.avc.ai/enhance` | 视频增强服务接口地址 |
+| `API_KEY` | **是** | - | API 认证密钥（视频、图片和 SAM3 服务共用） |
+| `HTTP_API_BASE_URL` | 否 | `https://mcp.avc.ai/enhance` | 视频与图片共用的 HTTP 服务接口地址 |
+| `IMAGE_API_BASE_URL` | 否 | 与 `HTTP_API_BASE_URL` 相同 | 可选图片接口覆盖；共享生产服务无需配置 |
 | `SAM3_API_BASE_URL` | 否 | `https://mcp.avc.ai/sam` | SAM3 服务接口地址 |
-| `SAM3_POLL_INTERVAL` | 否 | `2000` | SAM3 轮询间隔（毫秒） |
-| `SAM3_POLL_MAX_ATTEMPTS` | 否 | `25` | SAM3 最大轮询次数 |
+| `SAM3_POLL_INTERVAL_MS` | 否 | `2000` | SAM3 轮询间隔（毫秒，`SAM3_POLL_INTERVAL` 为已弃用别名） |
+| `SAM3_POLL_MAX_ATTEMPTS` | 否 | `25` | SAM3 最大状态查询次数；时间预算为 间隔 × 次数，任一限制先耗尽即截断等待 |
+
+`IMAGE_API_BASE_URL` 是可选的图片端点覆盖参数，用于把图片请求指向自定义图片服务。省略时，图片与视频请求共用 `HTTP_API_BASE_URL` 服务——这也是生产服务器的推荐配置。
 
 ### 自定义服务地址
 
 ```json
 {
   "env": {
-    "HTTP_API_BASE_URL": "https://your-endpoint.com",
+    "HTTP_API_BASE_URL": "https://your-media-endpoint.com",
     "API_KEY": "your-api-key",
     "SAM3_API_BASE_URL": "https://your-sam3-endpoint.com"
   }
@@ -135,9 +148,11 @@ AI 会自动完成：
 
 或通过命令行参数：
 ```bash
-npx -y @avclabs.ai/media-mcp@latest --base-url https://your-endpoint.com --api-key your-api-key --sam3-base-url https://your-sam3-endpoint.com
+npx -y @avclabs.ai/media-mcp@latest --base-url https://your-media-endpoint.com --api-key your-api-key --sam3-base-url https://your-sam3-endpoint.com
 ```
 
+可选的 `--image-base-url` 参数仅用于主动拆分公网图片端点的部署；当前 npm `latest` 版本不使用它（图片请求共用主端点）。
+
 ## 推荐的工作流程
 
 本项目提供了**同步**和**异步**两种模式。
@@ -157,15 +172,15 @@ npx -y @avclabs.ai/media-mcp@latest --base-url https://your-endpoint.com --api-k
 
 **视频增强**：
 - 调用 `enhance_video_sync` → 服务器内部自动轮询
-- 默认最多等待50秒
-- 如果50秒内完成，直接返回结果
-- 如果50秒未完成，返回 `task_id` 和提示，让 Agent 切换到 `get_task_status` 继续查询
+- 默认最多等待45秒
+- 如果45秒内完成，直接返回结果
+- 如果45秒未完成，返回 `task_id` 和提示，让 Agent 切换到 `get_task_status` 继续查询
 
 **图像分割 (SAM3)**：
 - 调用 `sam3_predict` → 服务器内部自动轮询
-- 默认最多等待50秒（25次 × 2秒轮询间隔）
-- 如果50秒内完成，直接返回分割结果
-- 如果50秒未完成，返回截断提示，告知任务仍在处理中
+- 默认最多25次状态查询、约50秒时间预算（25次 × 2秒间隔，任一限制先耗尽即截断等待）
+- 如果预算内完成，直接返回分割结果
+- 如果预算内未完成，返回携带 `task_id` 的截断提示，告知任务仍在处理中
 
 ## 使用示例
 
@@ -175,6 +190,12 @@ npx -y @avclabs.ai/media-mcp@latest --base-url https://your-endpoint.com --api-k
 
 > "把我桌面的 video.mp4 提升到 2k 画质"
 
+> "帮我把这张图片画质增强一下：https://example.com/photo.jpg"
+
+> "帮我把这张黑白照片上色：/Users/me/Desktop/old_photo.png"
+
+> "帮我把这张图片降噪去噪：C:\\Users\\xxx\\noisy.jpg"
+
 > "帮我分析这张图片，找出里面的所有物体：C:\\Users\\xxx\\photo.png"
 
 > "用 SAM3 分割这张图片，prompt 是 'find all cars'"
@@ -234,27 +255,141 @@ AI 会根据任务复杂度自动选择同步或异步工具完成任务。
 
 同步增强视频（阻塞等待完成）。
 
-> **仅适合短视频（预计处理时间 < 1 分钟）。** 如果任务在50秒内未完成，工具会提前返回并包含 `task_id`，你需要使用 `get_task_status` 继续查询。
+> **仅适合短视频（预计处理时间 < 1 分钟）。** 如果任务在默认45秒等待预算内未完成，工具会提前返回并包含 `task_id`，你需要使用 `get_task_status` 继续查询。
 
 | 参数 | 类型 | 必填 | 默认值 | 说明 |
 |---|---|---|---|---|
 | `video_source` | string | 是 | - | 视频 URL 或本地文件路径 |
 | `type` | string | 否 | `url` | `url` 或 `local` |
 | `resolution` | string | 否 | `720p` | 目标分辨率 |
-| `poll_interval` | number | 否 | `5` | 轮询间隔（秒） |
-| `timeout` | number | 否 | `50` | 同步等待超时时间（秒），超过后主动返回 |
+| `poll_interval` | number | 否 | `5` | 轮询间隔（秒，0.5-30） |
+| `timeout` | number | 否 | `45` | 同步等待超时时间（秒，1-45），超过后主动返回 |
 
-**截断返回示例（50秒未完成）：**
+**截断返回示例（默认45秒预算内未完成）：**
 ```json
 {
   "success": true,
   "status": "processing",
   "task_id": "xxx",
-  "message": "Task is still processing (waited 50 seconds). Please use get_task_status to continue polling.",
+  "message": "Task is still processing (waited 45 seconds, 9 status queries). Please use get_task_status to continue polling.",
   "note": "The synchronous wait for this long-running task has been truncated. Switch to get_task_status polling."
 }
 ```
 
+### 图片增强
+
+提供三个图片处理工具，分别针对不同场景：
+
+| 工具 | 功能 | 适用场景 |
+|---|---|---|
+| `enhance_image_sync` | 图片画质增强与人脸优化 | 模糊、低分辨率或画质下降的照片 |
+| `colorize_image_sync` | 黑白照片上色 | 为老旧黑白照片恢复真实色彩 |
+| `denoise_image_sync` | 图片降噪去噪 | 弱光环境下拍摄的噪点/颗粒感照片 |
+
+三个工具的参数和行为模式相同，均为**同步**调用——工具会阻塞直到图片处理完成或超时。
+
+**支持的图片格式**：PNG、JPG、JPEG、BMP、WebP 等。
+
+**两种上传方式**：
+1. **URL 上传**：提供公开可访问的图片 URL（`type: "url"`）
+2. **本地上传**：提供本地文件路径，MCP Server 自动上传到 TOS 对象存储（`type: "local"`，最大 100MB）
+
+#### enhance_image_sync
+
+同步增强图片画质并优化人脸。
+
+> 工具内部会创建任务并轮询结果。如果在超时时间内（默认 45 秒）处理完成，直接返回结果；否则提前返回 `task_id`，需用 `get_image_task_status` 继续轮询。
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|---|---|---|---|---|
+| `image_source` | string | 是 | - | 图片 URL 或本地文件路径（URL 必须公网可访问，不支持需要登录或签名的链接） |
+| `type` | string | 否 | `url` | `url` 或 `local` |
+| `scale` | number | 否 | `2` | 增强倍数（如 `2` 为 2 倍、`4` 为 4 倍放大） |
+| `poll_interval` | number | 否 | `5` | 轮询间隔（秒，0.5-30） |
+| `timeout` | number | 否 | `45` | 同步等待超时时间（秒，1-45），超过后主动返回 |
+
+**正常完成返回：**
+```json
+{
+  "success": true,
+  "task_id": "xxx",
+  "status": "completed",
+  "progress": 100,
+  "image_url": "https://..."
+}
+```
+
+**截断返回（默认45秒预算内未完成）：**
+```json
+{
+  "success": true,
+  "status": "processing",
+  "task_id": "xxx",
+  "message": "Task is still processing (waited 45 seconds, 9 status queries). Please use get_image_task_status to continue polling.",
+  "note": "The synchronous wait for this long-running task has been truncated. Switch to get_image_task_status polling."
+}
+```
+
+#### colorize_image_sync
+
+同步为黑白照片 AI 上色。
+
+> 适合老旧黑白照片，AI 会为图片添加真实色彩。参数与返回格式与 `enhance_image_sync` 相同。
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|---|---|---|---|---|
+| `image_source` | string | 是 | - | 图片 URL 或本地文件路径（URL 必须公网可访问，不支持需要登录或签名的链接） |
+| `type` | string | 否 | `url` | `url` 或 `local` |
+| `poll_interval` | number | 否 | `5` | 轮询间隔（秒，0.5-30） |
+| `timeout` | number | 否 | `45` | 同步等待超时时间（秒，1-45），超过后主动返回 |
+
+**返回值：** 与 `enhance_image_sync` 相同。
+
+#### denoise_image_sync
+
+同步为图片降噪去噪。
+
+> 适合弱光环境或高 ISO 拍摄的噪点/颗粒感照片。参数与返回格式与 `enhance_image_sync` 相同。
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|---|---|---|---|---|
+| `image_source` | string | 是 | - | 图片 URL 或本地文件路径（URL 必须公网可访问，不支持需要登录或签名的链接） |
+| `type` | string | 否 | `url` | `url` 或 `local` |
+| `poll_interval` | number | 否 | `5` | 轮询间隔（秒，0.5-30） |
+| `timeout` | number | 否 | `45` | 同步等待超时时间（秒，1-45），超过后主动返回 |
+
+**返回值：** 与 `enhance_image_sync` 相同。
+
+#### get_image_task_status
+
+查询图片处理任务状态。当同步工具超时后，用此工具轮询结果。
+
+> 返回值中的 `status` 字段可能为：`processing`（处理中）、`completed`（已完成）、`failed`（失败）。如果 `status` 为 `processing`，等待几秒后再次调用此工具。
+
+| 参数 | 类型 | 必填 |
+|---|---|---|
+| `task_id` | string | 是 |
+
+**返回值：**
+```json
+{
+  "success": true,
+  "task_id": "xxx",
+  "status": "completed",
+  "progress": 100,
+  "image_url": "https://...",
+  "message": "Task is still processing, please check again later"
+}
+```
+
+其中 `message` 字段只在 `status` 为 `processing` 时出现，提示 Agent 继续等待。
+
+#### 图片工具推荐工作流
+
+1. **大多数图片**：直接调用 `enhance_image_sync` / `colorize_image_sync` / `denoise_image_sync`，工具会完成全部流程并返回结果
+2. **如果被截断**：工具返回 `task_id`，然后用 `get_image_task_status` 轮询，直到 `status` 变为 `completed` 或 `failed`
+3. **如果失败**：查看 `error_message` 字段了解详情
+
 ### 图像分割 (SAM3)
 
 #### sam3_predict
@@ -309,19 +444,91 @@ AI 会根据任务复杂度自动选择同步或异步工具完成任务。
 }
 ```
 
-**截断返回示例（50秒未完成）：**
+**截断返回示例（预算内未完成）：**
+```json
+{
+  "success": true,
+  "status": "processing",
+  "task_id": "xxx",
+  "message": "Task is still processing (waited 50 seconds, 25 status queries). Please use get_sam3_task_status to continue polling.",
+  "note": "The synchronous wait for this long-running task has been truncated. Switch to task status polling."
+}
+```
+
+**结果下载失败（任务已完成、结果缺失）：**
+任务已完成但结果文件下载失败时，工具返回 `success: false`，同时携带 `task_id` 与 `status: "completed"`。请用该 `task_id` 调用 `get_sam3_task_status` 恢复结果，不要重新提交任务。
+```json
+{
+  "success": false,
+  "task_id": "xxx",
+  "status": "completed",
+  "error": "Failed to download the completed result for task xxx: ...",
+  "note": "The task has completed; only the result download failed. Do not resubmit. Use get_sam3_task_status with this task_id to recover the result."
+}
+```
+
+#### get_sam3_task_status
+
+查询 SAM3 分割任务状态。当 `sam3_predict` 超时后，用此工具轮询结果。
+
+> 返回值中的 `status` 字段可能为：`processing`（处理中）、`completed`（已完成）、`failed`（失败）。如果 `status` 为 `processing`，等待几秒后再次调用此工具。
+
+| 参数 | 类型 | 必填 |
+|---|---|---|
+| `task_id` | string | 是 |
+
+**已完成返回：**
+```json
+{
+  "success": true,
+  "task_id": "xxx",
+  "status": "completed",
+  "result_url": "https://..."
+}
+```
+
+**处理中返回：**
 ```json
 {
   "success": true,
+  "task_id": "xxx",
   "status": "processing",
+  "message": "Task is still processing, please check again later."
+}
+```
+
+**失败返回：**
+```json
+{
+  "success": false,
   "task_id": "xxx",
-  "message": "Task is still processing (waited about 50 seconds). Please retry later or record this task_id for manual follow-up.",
-  "note": "The synchronous wait for this long-running task has been truncated."
+  "status": "failed",
+  "error": "Task failed"
 }
 ```
 
 ## 常见问题
 
+### AVCLabs Media MCP 是免费的吗？
+
+注册即送免费额度，无需绑定信用卡。超出免费额度后按量付费：积分包（$19.95 起）和月订阅（$9.95/月起）。当前套餐见 https://mcp.avc.ai/pricing/ 。
+
+### 支持哪些 AI 客户端？
+
+任何兼容 MCP 的客户端。Claude Code、Cursor、Windsurf 有一键配置指南：https://mcp.avc.ai/docs/ （本包使用标准 MCP stdio 协议，其他 agent 使用相同的 `npx` 配置即可接入）。
+
+### 需要 GPU 或高性能硬件吗？
+
+不需要。视频增强与 SAM3 推理都在 AVCLabs 云端完成，本机只运行轻量的 MCP stdio 服务进程（Node.js 18+），普通笔记本即可。
+
+### API Key 在哪里获取？
+
+在 https://mcp.avc.ai/ 注册后在控制台创建。同一个 Key 同时用于视频增强、图片工具与 SAM3 分割。
+
+### `sam3_predict` 返回什么？
+
+文本提示所描述目标的像素级分割掩码（masks）、边界框（bounding boxes）和逐实例置信度分数——可直接用于合成、标注或后续分析。
+
 ### Agent 调用工具时报超时怎么办？
 
 这是本项目重点解决的问题。MCP Agent（如 Claude、Cursor）对单个 tool 调用通常有约 60 秒的超时限制。如果任务处理时间超过此限制，Agent 会报错并切断连接。
@@ -330,15 +537,11 @@ AI 会根据任务复杂度自动选择同步或异步工具完成任务。
 
 1. **优先使用异步工具**：对于视频增强等耗时任务，始终使用 `create_task` + `get_task_status`。这些工具每次调用都是瞬间返回的，不会触发超时。
 
-2. **同步工具的截断机制**：`enhance_video_sync` 已在内部设置了50秒的截断限制。如果任务未在50秒内完成，工具会主动返回 `task_id`，并提示 Agent 使用 `get_task_status` 继续跟进。
+2. **同步工具的截断机制**：`enhance_video_sync` 已在内部设置了45秒的截断限制（默认 `timeout`）。如果任务未在预算内完成，工具会主动返回 `task_id`，并提示 Agent 使用 `get_task_status` 继续跟进。
 
-3. **SAM3 的截断机制**：`sam3_predict` 默认轮询25次（约50秒），如果任务未完成会返回截断提示，告知任务仍在处理中。
+3. **SAM3 的截断机制**：`sam3_predict` 受两个独立限制约束：最多 `SAM3_POLL_MAX_ATTEMPTS` 次状态查询（默认25次）和时间预算 `SAM3_POLL_INTERVAL_MS × 次数`（默认 25 × 2秒 ≈ 50秒）。任一限制先耗尽即截断等待；返回的提示携带 `task_id` 以及实际经过时间和查询次数，远端任务继续运行。
 
-4. **调整 SAM3 轮询参数**（高级）：如果你确定 SAM3 任务通常很快（例如10秒内），可以通过环境变量增加轮询次数：
-   ```bash
-   SAM3_POLL_MAX_ATTEMPTS=60
-   ```
-   但请确保总等待时间不超过 Agent 的超时限制。
+4. **调整 SAM3 轮询参数**（高级）：两个限制相互独立，可以自由权衡间隔与次数（例如 `SAM3_POLL_INTERVAL_MS=1000` 配合 `SAM3_POLL_MAX_ATTEMPTS=50`，仍是约50秒预算、但查询频率翻倍）。如果任务通常几秒内完成，调低间隔可以更快发现完成状态。显式配置的非法值（非整数或超出允许范围）会在启动时直接报错退出，不会提交任何任务。等待预算只覆盖任务创建后的状态轮询——源准备、上传、任务提交和最后的结果下载都不计入，因此整个工具调用可能长于预算。
 
 ### 拖拽附件后提示找不到文件？
 
@@ -389,7 +592,7 @@ AI 会根据任务复杂度自动选择同步或异步工具完成任务。
 
 安装 Node.js >= 18：https://nodejs.org/
 
-### "Error: --api-key argument or API_KEY environment variable is required"
+### "API key is required: pass --api-key or set the API_KEY environment variable"
 
 API Key 缺失，请检查配置中的 `env.API_KEY`。
 
@@ -402,7 +605,7 @@ API Key 缺失，请检查配置中的 `env.API_KEY`。
 
 ### "TOS 上传失败"
 
-通常是签名不匹配，请确认 `HTTP_API_BASE_URL` 和 `API_KEY` 正确且有效。
+通常是签名不匹配，请确认 `IMAGE_API_BASE_URL`（未配置时回落到 `HTTP_API_BASE_URL`）和 `API_KEY` 正确且有效。
 
 ## 全局安装（可选）
 
@@ -414,6 +617,17 @@ npm install -g @avclabs.ai/media-mcp
 
 然后在配置中使用 `"command": "media-mcp"` 配合 `"args": ["--api-key", "your-api-key"]` 。
 
+## 开发与发布
+
+本包运行在 MCP 客户端本机，并通过 npm 发布；它不是部署到远程服务器的 Node 常驻进程。发布前验证工作区：
+
+```bash
+npm ci
+npm run release:verify
+```
+
+维护者请查阅[发布指南](https://github.com/avclabs/media-mcp/blob/main/docs/RELEASE.md)了解当前发布状态、版本同步、发布顺序、冒烟测试以及与门户/后端部署的关系。
+
 ## License
 
 MIT License - 详见 [LICENSE](LICENSE) 文件

package/config.json

@@ -1,4 +1,5 @@
 {
   "baseUrl": "https://mcp.avc.ai/enhance",
+  "imageBaseUrl": null,
   "sam3BaseUrl": "https://mcp.avc.ai/sam"
 }

package/dist/image-enhancement.d.ts

@@ -0,0 +1,3 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function setupImageEnhancementTools(server: McpServer, baseUrl: string, apiKey: string): void;
+//# sourceMappingURL=image-enhancement.d.ts.map

package/dist/image-enhancement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-enhancement.d.ts","sourceRoot":"","sources":["../src/image-enhancement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA8CpE,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAwEnG"}

package/dist/image-enhancement.js

@@ -0,0 +1,185 @@
+import axios from 'axios';
+import * as fs from 'fs';
+import { z } from 'zod';
+import { checkLocalFile, formatRequestError, parseTosSignature, unwrapEnvelope, uploadToTos, } from './tos.js';
+import { classifyStatus, POLL_REQUEST_TIMEOUT_MS, pollUntilTerminal, registerTool } from './tooling.js';
+const PollIntervalSchema = z.number().min(0.5).max(30).default(5).describe('Polling interval in seconds (0.5-30), default 5');
+const SyncTimeoutSchema = z.number().min(1).max(45).default(45).describe('Synchronous wait timeout in seconds (1-45), default 45. Returns task_id early when exceeded, use get_image_task_status to continue polling');
+// Schemas
+const EnhanceImageSyncSchema = z.object({
+    image_source: z.string().describe('Image URL or local file path (URL must be publicly accessible, login or signed links are not supported)'),
+    type: z.enum(['url', 'local']).default('url').describe('Upload type: url=remote image, local=local file'),
+    scale: z.number().int().min(1).max(4).default(2).describe('Enhancement scale multiplier (1-4), default 2. Controls the upscaling factor for image enhancement (e.g. 2=2x, 4=4x)'),
+    poll_interval: PollIntervalSchema,
+    timeout: SyncTimeoutSchema,
+});
+const ColorizeImageSyncSchema = z.object({
+    image_source: z.string().describe('Image URL or local file path (URL must be publicly accessible, login or signed links are not supported)'),
+    type: z.enum(['url', 'local']).default('url').describe('Upload type: url=remote image, local=local file'),
+    poll_interval: PollIntervalSchema,
+    timeout: SyncTimeoutSchema,
+});
+const DenoiseImageSyncSchema = z.object({
+    image_source: z.string().describe('Image URL or local file path (URL must be publicly accessible, login or signed links are not supported)'),
+    type: z.enum(['url', 'local']).default('url').describe('Upload type: url=remote image, local=local file'),
+    poll_interval: PollIntervalSchema,
+    timeout: SyncTimeoutSchema,
+});
+// Schema - status query
+const GetImageTaskStatusSchema = z.object({
+    task_id: z.string().describe('Task ID'),
+});
+export function setupImageEnhancementTools(server, baseUrl, apiKey) {
+    const client = axios.create({
+        baseURL: baseUrl.replace(/\/$/, ''),
+        headers: {
+            'Authorization': `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+        },
+        timeout: 60000,
+    });
+    // ========== Sync task tools ==========
+    registerTool(server, 'enhance_image_sync', `Enhance/upscale an image to improve quality (图片增强/放大/超分辨率). Use this tool ONLY for image enhancement and upscaling tasks.
+
+Two upload methods are supported:
+1. URL upload: provide an image URL
+2. Local upload: provide a local file path, the MCP Server will auto-upload to TOS object storage
+
+Best for images with estimated processing time < 1 minute. If the task is not completed within the timeout, the tool returns early with a task_id. Use get_image_task_status to continue polling.`, EnhanceImageSyncSchema.shape, async (args) => processImageSync(client, args.image_source, args.type, 'enhance', args.poll_interval, args.timeout, args.scale));
+    registerTool(server, 'colorize_image_sync', `Colorize a black-and-white photo (黑白照片上色/旧照片上色). Use this tool ONLY for adding color to grayscale or black-and-white images.
+
+Two upload methods are supported:
+1. URL upload: provide an image URL
+2. Local upload: provide a local file path, the MCP Server will auto-upload to TOS object storage
+
+Best for images with estimated processing time < 1 minute. If the task is not completed within the timeout, the tool returns early with a task_id. Use get_image_task_status to continue polling.`, ColorizeImageSyncSchema.shape, async (args) => processImageSync(client, args.image_source, args.type, 'colorize', args.poll_interval, args.timeout));
+    registerTool(server, 'denoise_image_sync', `Remove noise from an image (图片降噪/去噪). Use this tool ONLY for denoising noisy or grainy images.
+
+Two upload methods are supported:
+1. URL upload: provide an image URL
+2. Local upload: provide a local file path, the MCP Server will auto-upload to TOS object storage
+
+Best for images with estimated processing time < 1 minute. If the task is not completed within the timeout, the tool returns early with a task_id. Use get_image_task_status to continue polling.`, DenoiseImageSyncSchema.shape, async (args) => processImageSync(client, args.image_source, args.type, 'denoise', args.poll_interval, args.timeout));
+    // ========== Status query tool ==========
+    registerTool(server, 'get_image_task_status', 'Query image processing task status. The status field can be: processing, completed, or failed. If status is processing, wait a few seconds and call this tool again to poll.', GetImageTaskStatusSchema.shape, async (args) => {
+        const result = await getImageTaskStatus(client, args.task_id);
+        return {
+            ...result,
+            // registerTool marks isError on success===false: a terminal failed
+            // status is a failed query outcome, not a healthy poll tick.
+            success: classifyStatus(result.status) !== 'failed',
+            message: result.status === 'processing' ? 'Task is still processing, please check again later' : undefined,
+        };
+    });
+}
+async function getImageTosSignature(client, fileName) {
+    const response = await client.post('/api/v3/contents/generations/tos-signature', {
+        file_type: 'image',
+        file_name: fileName,
+    });
+    const unwrapped = unwrapEnvelope(response);
+    if (!unwrapped.ok) {
+        throw new Error(unwrapped.error);
+    }
+    return unwrapped.data;
+}
+function getEndpointByTaskType(taskType) {
+    switch (taskType) {
+        case 'enhance':
+            return '/api/v3/contents/generations/image/enhance';
+        case 'colorize':
+            return '/api/v3/contents/generations/image/colorize';
+        case 'denoise':
+            return '/api/v3/contents/generations/image/denoise';
+    }
+}
+function getModelByTaskType(taskType) {
+    switch (taskType) {
+        case 'enhance':
+            return 'avc-image-enhance';
+        case 'colorize':
+            return 'avc-image-colorize';
+        case 'denoise':
+            return 'avc-image-denoise';
+    }
+}
+async function createImageTask(client, imageSource, sourceType, taskType, scale) {
+    let contentItem;
+    if (sourceType === 'local') {
+        const fileInfo = checkLocalFile(imageSource, 'image');
+        // Step 1: Get TOS signature
+        let target;
+        try {
+            target = parseTosSignature(await getImageTosSignature(client, fileInfo.fileName));
+        }
+        catch (error) {
+            throw new Error(`[Step 1: TOS signature failed] ${formatRequestError(error)}`);
+        }
+        // Step 2: Upload to TOS
+        try {
+            await uploadToTos(target, fs.createReadStream(imageSource), fileInfo.fileName);
+        }
+        catch (error) {
+            throw new Error(`[Step 2: TOS upload failed] ${error.message}`);
+        }
+        contentItem = { type: 'image_file', file_id: target.fileId, file_name: fileInfo.fileName };
+    }
+    else {
+        contentItem = { type: 'image_url', image_url: { url: imageSource } };
+    }
+    // Step 3: Call image API
+    const endpoint = getEndpointByTaskType(taskType);
+    const payload = { model: getModelByTaskType(taskType), content: [contentItem] };
+    if (scale !== undefined) {
+        payload.scale = scale;
+    }
+    let response;
+    try {
+        response = await client.post(endpoint, payload);
+    }
+    catch (error) {
+        throw new Error(`[Step 3: API call failed] endpoint=${endpoint} ${formatRequestError(error)}`);
+    }
+    const unwrapped = unwrapEnvelope(response);
+    if (!unwrapped.ok) {
+        return { success: false, error: unwrapped.error };
+    }
+    return { success: true, task_id: unwrapped.data.task_id, status: unwrapped.data.status };
+}
+async function getImageTaskStatus(client, taskId, signal) {
+    const response = await client.get(`/api/v3/contents/generations/tasks/${encodeURIComponent(taskId)}`, {
+        timeout: POLL_REQUEST_TIMEOUT_MS,
+        signal,
+    });
+    const unwrapped = unwrapEnvelope(response);
+    if (!unwrapped.ok) {
+        throw new Error(unwrapped.error);
+    }
+    const result = unwrapped.data;
+    return {
+        task_id: result.task_id,
+        status: result.status,
+        progress: result.progress ?? 0,
+        image_url: result.image_url,
+        error_message: result.error_message,
+        created_at: result.created_at,
+        updated_at: result.updated_at,
+    };
+}
+async function processImageSync(client, imageSource, sourceType, taskType, pollInterval, timeout, scale) {
+    const createResult = await createImageTask(client, imageSource, sourceType, taskType, scale);
+    if (!createResult.success) {
+        return createResult;
+    }
+    return pollUntilTerminal({
+        taskId: createResult.task_id,
+        timeoutSeconds: timeout,
+        pollIntervalSeconds: pollInterval,
+        continueHint: 'get_image_task_status',
+        fetchStatus: async (signal) => {
+            const { task_id, status, ...payload } = await getImageTaskStatus(client, createResult.task_id, signal);
+            return { status, payload };
+        },
+    });
+}
+//# sourceMappingURL=image-enhancement.js.map

package/dist/image-enhancement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-enhancement.js","sourceRoot":"","sources":["../src/image-enhancement.ts"],"names":[],"mappings":"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"}

package/dist/sam3.d.ts

@@ -1,3 +1,10 @@
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function setupSam3Tools(server: McpServer, baseUrl: string, apiKey: string, pollInterval: number, pollMaxAttempts: number): void;
+/**
+ * Last-hop fetch for a completed SAM3 task. Never throws: a download failure
+ * becomes a structured object that keeps task_id and the terminal status, so
+ * the caller can resume via get_sam3_task_status. A download failure is not
+ * a truncated wait and never rewrites the remote status to failed/processing.
+ */
+export declare function fetchSam3ResultPayload(taskId: string, resultUrl: unknown): Promise<Record<string, any>>;
 //# sourceMappingURL=sam3.d.ts.map

package/dist/sam3.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sam3.d.ts","sourceRoot":"","sources":["../src/sam3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAcpE,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACtB,IAAI,CAsCN"}
+{"version":3,"file":"sam3.d.ts","sourceRoot":"","sources":["../src/sam3.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4BpE,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,GACtB,IAAI,CA8CN;AAkED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAwB7G"}