@avclabs.ai/media-mcp 0.3.0 → 0.4.0

package/README.md

@@ -1,14 +1,16 @@
-# media-mcp (Node.js)
+# media-mcp (Node.js, legacy all-in-one)
 
-English | [中文](https://github.com/avclabs/media-mcp/blob/main/README_CN.md)
+English | [中文](https://github.com/avclabs/media-mcp/blob/main/packages/media-mcp/README_CN.md)
+
+> **Maintenance note:** this package bundles all 9 tools in one server. New integrations should prefer the per-function packages — [@avclabs.ai/video-mcp](../video-mcp), [@avclabs.ai/image-mcp](../image-mcp), and [@avclabs.ai/sam3-mcp](../sam3-mcp) — so each MCP client session only loads the tool definitions it needs. This all-in-one server stays available and configuration-compatible; see the [repo README](https://github.com/avclabs/media-mcp#readme) for the migration matrix.
 
 [![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)
 
-A video enhancement, image enhancement/colorization/denoising, and image segmentation service based on the MCP protocol, acting as an MCP Client-Server to interact with backend HTTP Servers.
+A video enhancement, image enhancement/colorization/denoising, and image segmentation service based on the MCP protocol, acting as an MCP Client-Server to interact with the hosted AVCLabs media services.
 
-> **Release status:** the published npm package (`latest` = `0.2.1`) includes 3 video tools and 2 SAM3 tools. Image enhancement tools are in active development and will ship in an upcoming release — they are documented below for early adopters, but are not part of the published package yet.
+> **Release status:** the published npm package (`latest` = `0.3.0`) includes 9 tools — 3 video, 4 image, and 2 SAM3 — all production-ready.
 
 ## Features
 
@@ -19,7 +21,7 @@ Provides the following MCP Tools:
 - `get_task_status` - Query task status
 - `enhance_video_sync` - Synchronously enhance video (blocking wait, truncated at ~45s by default)
 
-**Image Enhancement (coming soon — not in the published package yet)**
+**Image Enhancement**
 - `enhance_image_sync` - Enhance image quality and optimize faces (supports URL or local file upload)
 - `colorize_image_sync` - Colorize black-and-white photos (supports URL or local file upload)
 - `denoise_image_sync` - Remove noise from images (supports URL or local file upload)
@@ -118,23 +120,22 @@ Or edit `~/.cursor/mcp.json`:
 After restarting your client, check if the tools are available:
 
 1. Or ask: "What tools do you have available?"
-2. With the current npm `latest=0.2.1`, you should see `create_task`, `get_task_status`, `enhance_video_sync`, `sam3_predict`, and `get_sam3_task_status`.
-3. Once the image tools ship in an upcoming release, you will additionally see `enhance_image_sync`, `colorize_image_sync`, `denoise_image_sync`, and `get_image_task_status`.
+2. With the current npm `latest=0.3.0`, you should see all 9 tools: `create_task`, `get_task_status`, `enhance_video_sync`, `enhance_image_sync`, `colorize_image_sync`, `denoise_image_sync`, `get_image_task_status`, `sam3_predict`, and `get_sam3_task_status`.
 
 ## Configuration Options
 
 | Variable | Required | Default | Description |
 |---|---|---|---|
 | `API_KEY` | **Yes** | - | API authentication key (shared by video, image, and SAM3 services) |
-| `HTTP_API_BASE_URL` | No | `https://mcp.avc.ai/enhance` | Shared video and image HTTP service endpoint |
-| `IMAGE_API_BASE_URL` | No | Same as `HTTP_API_BASE_URL` | Optional image endpoint override; omit for the shared production server |
-| `SAM3_API_BASE_URL` | No | `https://mcp.avc.ai/sam` | SAM3 service endpoint |
+| `HTTP_API_BASE_URL` | No | `https://mcp.avc.ai/enhance` | Shared video and image enhancement host address |
+| `IMAGE_API_BASE_URL` | No | Same as `HTTP_API_BASE_URL` | Optional image host override; omit for the shared production host |
+| `SAM3_API_BASE_URL` | No | `https://mcp.avc.ai/sam` | SAM3 host address |
 | `SAM3_POLL_INTERVAL_MS` | No | `2000` | SAM3 polling interval in milliseconds (`SAM3_POLL_INTERVAL` is a deprecated alias) |
 | `SAM3_POLL_MAX_ATTEMPTS` | No | `25` | SAM3 maximum status queries; the time budget is interval × attempts, and whichever limit is hit first truncates the wait |
 
-`IMAGE_API_BASE_URL` is an optional override for pointing image calls at a custom image endpoint. When omitted, image and video calls share the `HTTP_API_BASE_URL` service — the recommended setup for the production server.
+`IMAGE_API_BASE_URL` is an optional override for pointing image calls at a custom image host. When omitted, image and video calls share the `HTTP_API_BASE_URL` service — the recommended setup for the production server.
 
-### Custom Endpoint
+### Custom Host
 
 ```json
 {
@@ -151,7 +152,7 @@ Or via CLI args:
 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
 ```
 
-The optional `--image-base-url` flag is available for deployments that intentionally split the public image endpoint; the current npm `latest` release does not use it (image calls share the main endpoint).
+The optional `--image-base-url` flag is available for deployments that intentionally split the public image host; the current npm `latest` release does not use it (image calls share the main host).
 
 ## Recommended Workflow
 
@@ -626,7 +627,7 @@ npm ci
 npm run release:verify
 ```
 
-Maintainers: see the [release guide](https://github.com/avclabs/media-mcp/blob/main/docs/RELEASE.md) for the current release status, version synchronization, publish order, smoke tests, and the relationship with the portal/backend deployment.
+Maintainers: see the [release guide](https://github.com/avclabs/media-mcp/blob/main/docs/RELEASE.md) for the current release status, version synchronization, publish order, smoke tests, and the relationship with the portal and host-service deployment.
 
 ## License
 

package/README_CN.md

@@ -1,14 +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.2.1`）包含 3 个视频工具和 2 个 SAM3 工具。图片增强工具正在积极开发中，将在后续版本发布——下文已提前列出供尝鲜参考，但目前尚不包含在已发布的 npm 包中。
+> **发布状态**：当前 npm `latest`（`0.3.0`）包含 9 个工具——3 个视频、4 个图片、2 个 SAM3——全部正式可用。
 
 ## 功能
 
@@ -19,7 +21,7 @@
 - `get_task_status` - 查询任务状态
 - `enhance_video_sync` - 同步增强视频（阻塞等待，默认45秒截断）
 
-**图片增强（即将发布，暂不含于已发布的 npm 包）**
+**图片增强**
 - `enhance_image_sync` - 图片画质增强与人脸优化（支持 URL 或本地文件上传）
 - `colorize_image_sync` - 黑白照片上色（支持 URL 或本地文件上传）
 - `denoise_image_sync` - 图片降噪去噪（支持 URL 或本地文件上传）
@@ -118,21 +120,20 @@ AI 会自动完成：
 重启客户端后，确认工具是否加载成功：
 
 1. 或直接问 AI："你有哪些可用的工具？"
-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`。
+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` | 视频与图片共用的 HTTP 服务接口地址 |
-| `IMAGE_API_BASE_URL` | 否 | 与 `HTTP_API_BASE_URL` 相同 | 可选图片接口覆盖；共享生产服务无需配置 |
-| `SAM3_API_BASE_URL` | 否 | `https://mcp.avc.ai/sam` | 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` 服务——这也是生产服务器的推荐配置。
+`IMAGE_API_BASE_URL` 是可选的图片服务地址覆盖参数，用于把图片请求指向自定义图片服务。省略时，图片与视频请求共用 `HTTP_API_BASE_URL` 服务——这也是生产服务器的推荐配置。
 
 ### 自定义服务地址
 
@@ -151,7 +152,7 @@ AI 会自动完成：
 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` 版本不使用它（图片请求共用主端点）。
+可选的 `--image-base-url` 参数仅用于主动拆分公网图片服务地址的部署；当前 npm `latest` 版本不使用它（图片请求共用主服务地址）。
 
 ## 推荐的工作流程
 

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, image enhancement/colorization/denoising, 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,113 +1,41 @@
 #!/usr/bin/env node
 /**
- * MCP Server - Video enhancement, image enhancement/colorization/denoising, 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 { setupImageEnhancementTools } from './image-enhancement.js';
-import { setupSam3Tools } from './sam3.js';
-import { resolveMediaHostConfig } from './service-config.js';
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-function parseConfigFile(configPath) {
-    let raw;
-    try {
-        raw = fs.readFileSync(configPath, 'utf-8');
-    }
-    catch (error) {
-        console.error(`Error: cannot read config file ${configPath}: ${error instanceof Error ? error.message : String(error)}`);
-        process.exit(1);
-    }
-    let config;
-    try {
-        config = JSON.parse(raw);
-    }
-    catch (error) {
-        console.error(`Error: config file ${configPath} is not valid JSON: ${error instanceof Error ? error.message : String(error)}`);
-        process.exit(1);
-    }
-    // Absent keys stay undefined; defaults are applied by resolveMediaHostConfig.
-    return {
-        baseUrl: typeof config.baseUrl === 'string' ? config.baseUrl : undefined,
-        imageBaseUrl: typeof config.imageBaseUrl === 'string' ? config.imageBaseUrl : undefined,
-        sam3BaseUrl: typeof config.sam3BaseUrl === 'string' ? config.sam3BaseUrl : undefined,
-    };
-}
-function loadConfig(explicitConfigPath) {
-    if (explicitConfigPath) {
-        const resolved = path.resolve(explicitConfigPath);
-        console.error(`Using config file: ${resolved}`);
-        return parseConfigFile(resolved);
-    }
-    // Only the config bundled with the package is considered; a config.json in
-    // the caller's working directory must never silently redirect API traffic.
-    const bundledPath = path.resolve(__dirname, '..', 'config.json');
-    if (fs.existsSync(bundledPath)) {
-        return parseConfigFile(bundledPath);
-    }
-    return {};
-}
-// Collect CLI values without consulting the environment; precedence between
-// layers is resolved by resolveMediaHostConfig.
-function parseCliOverrides(args) {
-    const overrides = {};
-    for (let i = 0; i < args.length; i++) {
-        const takeValue = (key) => {
-            overrides[key] = args[i + 1];
-            i++;
-        };
-        if (args[i] === '--base-url' && i + 1 < args.length)
-            takeValue('baseUrl');
-        else if (args[i] === '--image-base-url' && i + 1 < args.length)
-            takeValue('imageBaseUrl');
-        else if (args[i] === '--api-key' && i + 1 < args.length)
-            takeValue('apiKey');
-        else if (args[i] === '--sam3-base-url' && i + 1 < args.length)
-            takeValue('sam3BaseUrl');
-        else if (args[i] === '--sam3-poll-interval' && i + 1 < args.length)
-            takeValue('sam3PollIntervalMs');
-        else if (args[i] === '--sam3-poll-max-attempts' && i + 1 < args.length)
-            takeValue('sam3PollMaxAttempts');
-    }
-    return overrides;
-}
-// 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);
-    let explicitConfigPath;
-    for (let i = 0; i < args.length; i++) {
-        if (args[i] === '--config' && i + 1 < args.length) {
-            explicitConfigPath = args[i + 1];
-            break;
-        }
-    }
-    const fileConfig = loadConfig(explicitConfigPath);
-    // SAM3's sync wait is bounded by two independent limits derived from its
-    // config: at most SAM3_POLL_MAX_ATTEMPTS status queries and a time budget of
-    // interval x attempts (default 25 x 2000 ms = 50 s). Whichever runs out
-    // first truncates the wait; the task keeps running remotely either way.
-    const hostConfig = resolveMediaHostConfig({ cli: parseCliOverrides(args), env: process.env, file: fileConfig });
-    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, 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);
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
-    console.error('MCP Server running on stdio');
 }
 main().catch((error) => {
     console.error('Server error:', error);

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACnH,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,sFAAsF;AACtF,MAAM,cAAc,GAAG,OAAO,CAAC;AAE/B,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE/E,MAAM,UAAU,GAAG,sBAAsB,CAAC;QACxC,GAAG,EAAE,eAAe,CAAC,IAAI,EAAE;YACzB,YAAY,EAAE,SAAS;YACvB,kBAAkB,EAAE,cAAc;YAClC,WAAW,EAAE,QAAQ;YACrB,iBAAiB,EAAE,aAAa;YAChC,sBAAsB,EAAE,oBAAoB;YAC5C,0BAA0B,EAAE,qBAAqB;SAClD,CAAC;QACF,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,IAAI,EAAE,UAAU;KACjB,CAAC,CAAC;IAEH,MAAM,cAAc,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE;QAC9E,mCAAmC;QACnC,0BAA0B,CAAC,MAAM,EAAE,UAAU,CAAC,qBAAqB,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAExF,mCAAmC;QACnC,0BAA0B,CAAC,MAAM,EAAE,UAAU,CAAC,eAAe,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAElF,sBAAsB;QACtB,cAAc,CACZ,MAAM,EACN,UAAU,CAAC,cAAc,EACzB,UAAU,CAAC,MAAM,EACjB,UAAU,CAAC,kBAAkB,EAC7B,UAAU,CAAC,mBAAmB,CAC/B,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,11 +1,18 @@
 {
   "type": "module",
   "name": "@avclabs.ai/media-mcp",
-  "version": "0.3.0",
-  "description": "MCP Server for video enhancement, image enhancement/colorization/denoising, and image segmentation (SAM3)",
+  "version": "0.4.0",
+  "description": "Legacy all-in-one MCP Server for video enhancement, image enhancement/colorization/denoising, and image segmentation (SAM3). Prefer the per-function packages @avclabs.ai/video-mcp, @avclabs.ai/image-mcp, and @avclabs.ai/sam3-mcp.",
   "mcpName": "io.github.avclabs/media-mcp",
-  "main": "dist/server.js",
-  "types": "dist/server.d.ts",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
   "bin": {
     "media-mcp": "dist/server.js"
   },
@@ -18,12 +25,8 @@
   ],
   "scripts": {
     "build": "tsc",
-    "check:release": "node scripts/check-release.mjs",
     "dev": "tsc --watch",
-    "prepare": "npm run build",
-    "prepublishOnly": "npm run build",
-    "test": "npm run build && node --test tests/*.test.mjs",
-    "release:verify": "npm run check:release && npm audit --omit=dev --audit-level=high && npm test && npm pack --dry-run"
+    "prepublishOnly": "npm run build"
   },
   "keywords": [
     "mcp",
@@ -33,30 +36,19 @@
     "enhancement",
     "colorization",
     "denoising",
-    "http",
-    "client",
-    "server",
-    "claude",
-    "anthropic"
+    "server"
   ],
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/avclabs/media-mcp.git"
+    "url": "git+https://github.com/avclabs/media-mcp.git",
+    "directory": "packages/media-mcp"
   },
-  "bugs": {
-    "url": "https://github.com/avclabs/media-mcp/issues"
-  },
-  "homepage": "https://github.com/avclabs/media-mcp#readme",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0",
-    "axios": "^1.7.0",
-    "form-data": "^4.0.5",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "typescript": "^5.4.0"
+    "@avclabs.ai/media-mcp-core": "^0.1.0",
+    "@avclabs.ai/video-mcp": "^0.1.0",
+    "@avclabs.ai/image-mcp": "^0.1.0",
+    "@avclabs.ai/sam3-mcp": "^0.1.0"
   },
   "mcpServer": {
     "command": "npx",
@@ -69,7 +61,7 @@
       "HTTP_API_BASE_URL": "https://mcp.avc.ai/enhance",
       "SAM3_API_BASE_URL": "https://mcp.avc.ai/sam"
     },
-    "description": "视频增强 + 图片增强/上色/降噪 + SAM3 图像分割 MCP 服务",
+    "description": "视频增强 + 图片增强/上色/降噪 + SAM3 图像分割 MCP 服务（全量 9 工具；推荐改用按功能拆分的 video-mcp / image-mcp / sam3-mcp）",
     "setup": "需要替换 env.API_KEY 为你的 API Key"
   },
   "engines": {

package/dist/image-enhancement.d.ts

@@ -1,3 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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"}