@avclabs.ai/media-mcp 0.2.1 → 0.4.0

package/README_CN.md

@@ -1,12 +1,16 @@
-# media-mcp (Node.js)
+# media-mcp（Node.js，旧版全量包）
 
-[English](https://github.com/avclabs/media-mcp/blob/main/README.md) | 中文
+[English](https://github.com/avclabs/media-mcp/blob/main/packages/media-mcp/README.md) | 中文
+
+> **维护说明**：本包将全部 9 个工具打包在一个 server 中。新的接入建议改用按功能拆分的 [@avclabs.ai/video-mcp](../video-mcp)、[@avclabs.ai/image-mcp](../image-mcp)、[@avclabs.ai/sam3-mcp](../sam3-mcp)，让每个 MCP 客户端会话只加载自己需要的工具定义。本全量包继续可用且配置完全兼容；迁移矩阵见[仓库 README](https://github.com/avclabs/media-mcp#readme)。
 
 [![npm version](https://img.shields.io/npm/v/@avclabs.ai/media-mcp)](https://www.npmjs.com/package/@avclabs.ai/media-mcp)
 [![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 与 AVCLabs 云端媒体服务交互。
+
+> **发布状态**：当前 npm `latest`（`0.3.0`）包含 9 个工具——3 个视频、4 个图片、2 个 SAM3——全部正式可用。
 
 ## 功能
 
@@ -15,10 +19,17 @@
 **视频增强**
 - `create_task` - 创建视频增强任务（支持 URL 或本地文件上传）
 - `get_task_status` - 查询任务状态
-- `enhance_video_sync` - 同步增强视频（阻塞等待，默认50秒截断）
+- `enhance_video_sync` - 同步增强视频（阻塞等待，默认45秒截断）
+
+**图片增强**
+- `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 +120,27 @@ AI 会自动完成：
 重启客户端后，确认工具是否加载成功：
 
 1. 或直接问 AI："你有哪些可用的工具？"
-2. 应看到：`create_task`、`get_task_status`、`enhance_video_sync`、`sam3_predict`
+2. 当前 npm `latest=0.3.0` 应看到全部 9 个工具：`create_task`、`get_task_status`、`enhance_video_sync`、`enhance_image_sync`、`colorize_image_sync`、`denoise_image_sync`、`get_image_task_status`、`sam3_predict`、`get_sam3_task_status`。
 
 ## 配置项
 
 | 变量名 | 必填 | 默认值 | 说明 |
 |---|---|---|---|
-| `API_KEY` | **是** | - | API 认证密钥（视频增强和 SAM3 共用） |
-| `HTTP_API_BASE_URL` | 否 | `https://mcp.avc.ai/enhance` | 视频增强服务接口地址 |
-| `SAM3_API_BASE_URL` | 否 | `https://mcp.avc.ai/sam` | SAM3 服务接口地址 |
-| `SAM3_POLL_INTERVAL` | 否 | `2000` | SAM3 轮询间隔（毫秒） |
-| `SAM3_POLL_MAX_ATTEMPTS` | 否 | `25` | SAM3 最大轮询次数 |
+| `API_KEY` | **是** | - | API 认证密钥（视频、图片和 SAM3 服务共用） |
+| `HTTP_API_BASE_URL` | 否 | `https://mcp.avc.ai/enhance` | 视频与图片共用的增强服务地址 |
+| `IMAGE_API_BASE_URL` | 否 | 与 `HTTP_API_BASE_URL` 相同 | 可选图片服务地址覆盖；共享生产服务无需配置 |
+| `SAM3_API_BASE_URL` | 否 | `https://mcp.avc.ai/sam` | 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 +149,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 +173,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 +191,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 +256,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 +445,91 @@ AI 会根据任务复杂度自动选择同步或异步工具完成任务。
 }
 ```
 
-**截断返回示例（50秒未完成）：**
+**截断返回示例（预算内未完成）：**
 ```json
 {
   "success": true,
   "status": "processing",
   "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."
+  "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",
+  "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 +538,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 +593,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 +606,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 +618,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/config.d.ts

@@ -0,0 +1,36 @@
+import { ConfigError } from '@avclabs.ai/media-mcp-core';
+export { ConfigError };
+export interface MediaHostCliOverrides {
+    baseUrl?: string;
+    imageBaseUrl?: string;
+    sam3BaseUrl?: string;
+    apiKey?: string;
+    /** Raw argument text; parsed and bounds-checked by the sam3 resolver. */
+    sam3PollIntervalMs?: string;
+    sam3PollMaxAttempts?: string;
+}
+export interface MediaHostEnv {
+    API_KEY?: string;
+    HTTP_API_BASE_URL?: string;
+    IMAGE_API_BASE_URL?: string;
+    SAM3_API_BASE_URL?: string;
+    /** Canonical name. */
+    SAM3_POLL_INTERVAL_MS?: string;
+    /** Deprecated alias of SAM3_POLL_INTERVAL_MS. */
+    SAM3_POLL_INTERVAL?: string;
+    SAM3_POLL_MAX_ATTEMPTS?: string;
+}
+export interface MediaHostConfig {
+    enhancementApiBaseUrl: string;
+    imageApiBaseUrl: string;
+    sam3ApiBaseUrl: string;
+    apiKey: string;
+    sam3PollIntervalMs: number;
+    sam3PollMaxAttempts: number;
+}
+export declare function resolveMediaHostConfig(options: {
+    cli?: MediaHostCliOverrides;
+    env?: MediaHostEnv;
+    file?: Record<string, unknown>;
+}): MediaHostConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAKzD,OAAO,EAAE,WAAW,EAAE,CAAC;AAEvB,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,sBAAsB;IACtB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,iDAAiD;IACjD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,GAAG,CAAC,EAAE,qBAAqB,CAAC;IAC5B,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC,GAAG,eAAe,CAYlB"}

package/dist/config.js

@@ -0,0 +1,25 @@
+// Legacy all-in-one host configuration. Composes the per-package resolvers so
+// resolveMediaHostConfig keeps its historical semantics exactly: precedence
+// per key is CLI > environment > file config > built-in default, the image
+// base derives from the RESOLVED enhancement base, and validation happens
+// before any tool is created. New integrations should use the per-function
+// packages instead of this one.
+import { ConfigError } from '@avclabs.ai/media-mcp-core';
+import { resolveVideoConfig } from '@avclabs.ai/video-mcp';
+import { resolveImageConfig } from '@avclabs.ai/image-mcp';
+import { resolveSam3Config } from '@avclabs.ai/sam3-mcp';
+export { ConfigError };
+export function resolveMediaHostConfig(options) {
+    const video = resolveVideoConfig(options);
+    const image = resolveImageConfig(options);
+    const sam3 = resolveSam3Config(options);
+    return {
+        enhancementApiBaseUrl: video.apiBaseUrl,
+        imageApiBaseUrl: image.imageApiBaseUrl,
+        sam3ApiBaseUrl: sam3.apiBaseUrl,
+        apiKey: video.apiKey,
+        sam3PollIntervalMs: sam3.pollIntervalMs,
+        sam3PollMaxAttempts: sam3.pollMaxAttempts,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,4EAA4E;AAC5E,2EAA2E;AAC3E,0EAA0E;AAC1E,2EAA2E;AAC3E,gCAAgC;AAEhC,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,CAAC;AAiCvB,MAAM,UAAU,sBAAsB,CAAC,OAItC;IACC,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IACxC,OAAO;QACL,qBAAqB,EAAE,KAAK,CAAC,UAAU;QACvC,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,cAAc,EAAE,IAAI,CAAC,UAAU;QAC/B,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,kBAAkB,EAAE,IAAI,CAAC,cAAc;QACvC,mBAAmB,EAAE,IAAI,CAAC,eAAe;KAC1C,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { ConfigError, MediaHostCliOverrides, MediaHostConfig, MediaHostEnv, resolveMediaHostConfig, } from './config.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,WAAW,EACX,qBAAqB,EACrB,eAAe,EACf,YAAY,EACZ,sBAAsB,GACvB,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+// Library surface for the legacy all-in-one package. The bin entry
+// (server.ts) is deliberately not exported here: importing it starts the
+// stdio server.
+export { ConfigError, resolveMediaHostConfig, } from './config.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,yEAAyE;AACzE,gBAAgB;AAChB,OAAO,EACL,WAAW,EAIX,sBAAsB,GACvB,MAAM,aAAa,CAAC"}

package/dist/server.d.ts

@@ -1,6 +1,10 @@
 #!/usr/bin/env node
 /**
- * MCP Server - Video enhancement and SAM3 image segmentation
+ * media-mcp — legacy all-in-one MCP server: video enhancement, image
+ * enhancement/colorization/denoising, and SAM3 image segmentation (9 tools).
+ * Prefer the per-function packages @avclabs.ai/video-mcp, @avclabs.ai/image-mcp,
+ * and @avclabs.ai/sam3-mcp; this entry keeps existing client configurations
+ * working unchanged.
  */
 export {};
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;GAEG"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;GAMG"}

package/dist/server.js

@@ -1,89 +1,41 @@
 #!/usr/bin/env node
 /**
- * MCP Server - Video enhancement and SAM3 image segmentation
+ * media-mcp — legacy all-in-one MCP server: video enhancement, image
+ * enhancement/colorization/denoising, and SAM3 image segmentation (9 tools).
+ * Prefer the per-function packages @avclabs.ai/video-mcp, @avclabs.ai/image-mcp,
+ * and @avclabs.ai/sam3-mcp; this entry keeps existing client configurations
+ * working unchanged.
  */
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import * as fs from 'fs';
-import * as path from 'path';
-import { fileURLToPath } from 'url';
-import { setupVideoEnhancementTools } from './video-enhancement.js';
-import { setupSam3Tools } from './sam3.js';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-function loadConfig() {
-    const configPaths = [
-        path.resolve(process.cwd(), 'config.json'),
-        path.resolve(__dirname, '..', 'config.json'),
-    ];
-    for (const configPath of configPaths) {
-        if (fs.existsSync(configPath)) {
-            try {
-                const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
-                return {
-                    baseUrl: config.baseUrl || 'https://mcp.avc.ai/enhance',
-                    sam3BaseUrl: config.sam3BaseUrl || 'https://mcp.avc.ai/sam',
-                };
-            }
-            catch {
-                continue;
-            }
-        }
-    }
-    return { baseUrl: 'https://mcp.avc.ai/enhance', sam3BaseUrl: 'https://mcp.avc.ai/sam' };
-}
-// Main entry
+import { extractConfigPath, loadBundledConfig, parseFlagValues, runStdioServer } from '@avclabs.ai/media-mcp-core';
+import { setupVideoEnhancementTools } from '@avclabs.ai/video-mcp';
+import { setupImageEnhancementTools } from '@avclabs.ai/image-mcp';
+import { setupSam3Tools } from '@avclabs.ai/sam3-mcp';
+import { resolveMediaHostConfig } from './config.js';
+// Kept in sync with package.json; scripts/check-release.mjs fails the build on drift.
+const SERVER_VERSION = '0.4.0';
 async function main() {
     const args = process.argv.slice(2);
-    const config = loadConfig();
-    let baseUrl = process.env.HTTP_API_BASE_URL || config.baseUrl;
-    let apiKey = process.env.API_KEY || '';
-    let sam3BaseUrl = process.env.SAM3_API_BASE_URL || config.sam3BaseUrl;
-    let sam3ApiKey = apiKey;
-    let sam3PollInterval = parseInt(process.env.SAM3_POLL_INTERVAL || '2000', 10);
-    let sam3PollMaxAttempts = parseInt(process.env.SAM3_POLL_MAX_ATTEMPTS || '25', 10);
-    // Parse command line arguments
-    for (let i = 0; i < args.length; i++) {
-        if (args[i] === '--base-url' && i + 1 < args.length) {
-            baseUrl = args[i + 1];
-            i++;
-        }
-        else if (args[i] === '--api-key' && i + 1 < args.length) {
-            apiKey = args[i + 1];
-            i++;
-        }
-        else if (args[i] === '--sam3-base-url' && i + 1 < args.length) {
-            sam3BaseUrl = args[i + 1];
-            i++;
-        }
-        else if (args[i] === '--sam3-poll-interval' && i + 1 < args.length) {
-            sam3PollInterval = parseInt(args[i + 1], 10);
-            i++;
-        }
-        else if (args[i] === '--sam3-poll-max-attempts' && i + 1 < args.length) {
-            sam3PollMaxAttempts = parseInt(args[i + 1], 10);
-            i++;
-        }
-    }
-    if (!apiKey) {
-        console.error('Error: --api-key argument or API_KEY environment variable is required');
-        process.exit(1);
-    }
-    const server = new McpServer({
-        name: 'media-mcp',
-        version: '0.3.0',
-    }, {
-        capabilities: {
-            tools: {},
-        },
+    const fileConfig = loadBundledConfig(extractConfigPath(args), import.meta.url);
+    const hostConfig = resolveMediaHostConfig({
+        cli: parseFlagValues(args, {
+            '--base-url': 'baseUrl',
+            '--image-base-url': 'imageBaseUrl',
+            '--api-key': 'apiKey',
+            '--sam3-base-url': 'sam3BaseUrl',
+            '--sam3-poll-interval': 'sam3PollIntervalMs',
+            '--sam3-poll-max-attempts': 'sam3PollMaxAttempts',
+        }),
+        env: process.env,
+        file: fileConfig,
+    });
+    await runStdioServer({ name: 'media-mcp', version: SERVER_VERSION }, (server) => {
+        // Register video enhancement tools
+        setupVideoEnhancementTools(server, hostConfig.enhancementApiBaseUrl, hostConfig.apiKey);
+        // Register image enhancement tools
+        setupImageEnhancementTools(server, hostConfig.imageApiBaseUrl, hostConfig.apiKey);
+        // Register SAM3 tools
+        setupSam3Tools(server, hostConfig.sam3ApiBaseUrl, hostConfig.apiKey, hostConfig.sam3PollIntervalMs, hostConfig.sam3PollMaxAttempts);
     });
-    // Register video enhancement tools
-    setupVideoEnhancementTools(server, baseUrl, apiKey);
-    // Register SAM3 tools
-    setupSam3Tools(server, sam3BaseUrl, sam3ApiKey, sam3PollInterval, sam3PollMaxAttempts);
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    console.error('MCP Server running on stdio');
 }
 main().catch((error) => {
     console.error('Server error:', error);