@avclabs.ai/media-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 http-mcp-client-server
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,333 @@
+# media-mcp (Node.js)
+
+中文 | [English](https://github.com/avclabs/media-mcp/blob/main/README_EN.md)
+
+[![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 Tools：
+- `create_task` - 创建视频增强任务（支持 URL 或本地文件上传）
+- `get_task_status` - 查询任务状态
+- `enhance_video_sync` - 同步增强视频（阻塞等待完成）
+- `sam3_predict` - SAM3 图像分割（支持本地路径、URL 或 Base64 图片）
+
+## 前置要求
+
+- **Node.js >= 18**（检查：`node --version`）
+- **API Key**（用于身份认证，请联系服务提供方获取）
+
+## 懒人安装（推荐）
+
+如果你使用的 AI Agent 有确定的 MCP 配置路径，直接复制下面这句发给 AI：
+
+```
+帮我安装 npm 包 @avclabs.ai/media-mcp 作为 MCP server。我的 API Key 是：sk-xxxxxxxx。
+```
+
+AI 会自动完成：
+1. 检测你使用的 MCP 客户端
+2. 找到配置文件路径
+3. 写入正确的配置
+4. 提示你重启客户端
+
+## 手动安装
+
+无需安装，直接在 MCP 客户端配置中使用 `npx` 运行。
+
+### 1. Claude Code（CLI）
+
+在 Claude Code 中运行：
+
+```
+/mcp
+```
+
+查看输出中 **"User MCPs"** 对应的配置文件路径，然后编辑该文件。
+
+常见路径（如果 `/mcp` 不可用）：
+- **Windows**: `%USERPROFILE%\.claude.json`
+- **macOS**: `~/.claude.json`
+- **Linux**: `~/.claude.json`
+- **旧版/备用**: `~/.claude/mcp.json`
+
+粘贴以下内容（将 `your-api-key` 替换为实际 API Key）：
+
+```json
+{
+  "mcpServers": {
+    "video-enhancement": {
+      "command": "npx",
+      "args": ["-y", "@avclabs.ai/media-mcp@latest"],
+      "env": {
+        "API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+保存后运行 `/mcp` 验证是否加载成功。
+
+### 2. Cursor
+
+进入 **设置 > Tools & MCPs > Add New MCP Server**：
+
+- **Name**：`video-enhancement`
+- **Type**：`command`
+- **Command**：
+  ```bash
+  env HTTP_API_KEY=your-api-key npx -y @avclabs.ai/media-mcp@latest
+  ```
+
+或编辑 `~/.cursor/mcp.json`：
+
+```json
+{
+  "mcpServers": {
+    "video-enhancement": {
+      "command": "npx",
+      "args": ["-y", "@avclabs.ai/media-mcp@latest"],
+      "env": {
+        "API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## 验证安装
+
+重启客户端后，确认工具是否加载成功：
+
+1. 或直接问 AI："你有哪些可用的工具？"
+2. 应看到：`create_task`、`get_task_status`、`enhance_video_sync`、`sam3_predict`
+
+## 配置项
+
+| 变量名 | 必填 | 默认值 | 说明 |
+|---|---|---|---|
+| `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_POLL_MAX_ATTEMPTS` | 否 | `60` | 最大轮询次数 |
+
+### 自定义服务地址
+
+```json
+{
+  "env": {
+    "HTTP_API_BASE_URL": "https://your-endpoint.com",
+    "API_KEY": "your-api-key",
+    "SAM3_API_BASE_URL": "http://localhost:8001"
+  }
+}
+```
+
+或通过命令行参数：
+```bash
+npx -y @avclabs.ai/media-mcp@latest --base-url https://your-endpoint.com --api-key your-api-key --sam3-base-url http://localhost:8001
+```
+
+## 使用示例
+
+配置完成后，用自然语言对 AI 说：
+
+> "帮我把这个视频增强到 1080p：https://example.com/video.mp4"
+
+> "把我桌面的 video.mp4 提升到 2k 画质"
+
+AI 会自动调用相应工具完成任务。
+
+> "帮我分析一下这张图片，找出里面的所有物体：C:\\Users\\xxx\\photo.png"
+>
+> "用 SAM3 分割这张图片，prompt 是 'find all cars'"
+
+## 提供的 Tools
+
+### create_task
+
+创建视频增强任务（异步）。
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|---|---|---|---|---|
+| `video_source` | string | 是 | - | 视频 URL 或本地文件路径（URL 必须公网可访问，不支持需要登录或签名的链接） |
+| `type` | string | 否 | `url` | `url` 或 `local` |
+| `resolution` | string | 否 | `720p` | `480p`、`540p`、`720p`、`1080p`、`2k` |
+
+**返回值：**
+```json
+{
+  "success": true,
+  "task_id": "xxx",
+  "status": "wait"
+}
+```
+
+### get_task_status
+
+查询任务状态。
+
+| 参数 | 类型 | 必填 |
+|---|---|---|
+| `task_id` | string | 是 |
+
+**返回值：**
+```json
+{
+  "success": true,
+  "task_id": "xxx",
+  "status": "completed",
+  "progress": 100,
+  "video_url": "https://..."
+}
+```
+
+### enhance_video_sync
+
+同步增强视频（阻塞等待完成）。
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|---|---|---|---|---|
+| `video_source` | string | 是 | - | 视频 URL 或本地文件路径（URL 必须公网可访问，不支持需要登录或签名的链接） |
+| `type` | string | 否 | `url` | `url` 或 `local` |
+| `resolution` | string | 否 | `720p` | 目标分辨率 |
+| `poll_interval` | number | 否 | `5` | 轮询间隔（秒） |
+| `timeout` | number | 否 | `600` | 超时时间（秒） |
+
+### sam3_predict
+
+使用 SAM3 分割 API 分析图片，生成推理结果（masks、boxes、scores）。
+
+**参数：**
+
+图片输入（三选一，必须提供其中一种）：
+
+- `imagePath` (string): 本地图片的绝对路径。支持常见图片格式（如 PNG、JPG、JPEG）。
+  - 示例：`"C:\\Users\\xxx\\photo.png"`、`"/home/user/images/cat.jpg"`
+  - 适用场景：用户明确提供了本地文件路径
+
+- `imageUrl` (string): 公开可访问的图片 URL。
+  - 示例：`"https://example.com/photo.jpg"`
+  - 适用场景：图片已在网上，用户提供了链接
+  - 注意：URL 必须公开可访问，不支持需要登录或签名的链接
+
+- `imageBase64` (string): Base64 编码的图片数据。
+  - 示例：`"iVBORw0KGgoAAAANSUhEUgAA..."`
+  - 适用场景：用户拖拽或上传了图片附件，Agent 将图片编码为 base64 后传入
+  - 注意：大图片的 base64 数据会比较大，传输时间可能稍长
+
+其他参数：
+
+- `prompt` (string, required): 英文文本提示，用于指定要在图片中分割的目标物体。例如 `"person"`、`"car"`、`"a cat sitting on a sofa"`。由于 SAM3 模型仅接受英文 prompt，建议传入英文描述。如果用户提供中文或其他非英文文本，Agent 会自动翻译为英文后调用。
+
+**返回：**
+
+推理完成后，直接返回 JSON 字符串。该 JSON 包含以下三个字段：
+
+- **`masks`**：二维数组。每个元素是一个与输入图片尺寸相同的二值掩码（取值为 0 或 1），用于标记检测到的物体在图片中的像素级位置。数组中的第 i 个掩码对应第 i 个检测到的物体实例。
+- **`boxes`**：二维数组。每个元素是 `[x1, y1, x2, y2]` 格式的边界框坐标，表示检测到的物体在图片中的矩形区域。`x1`、`y1` 为左上角坐标，`x2`、`y2` 为右下角坐标。
+
+  坐标系说明：以图片左上角为原点 `(0, 0)`，`x` 轴向右增长，`y` 轴向下增长，单位为像素。例如 `[120, 80, 300, 450]` 表示该物体区域从图片左边缘向右 120px、上边缘向下 80px 处开始，延伸至左边缘向右 300px、上边缘向下 450px 处结束，区域宽度为 `x2 - x1 = 180px`，高度为 `y2 - y1 = 370px`。
+- **`scores`**：一维数组。每个元素是对应检测结果的置信度分数，取值范围为 0 到 1。分数越高，表示模型对该检测结果的把握越大。
+
+结果 JSON 内容示例：
+
+```json
+{
+  "masks": [
+    [[0, 0, 1, ...], [0, 1, 1, ...], ...],
+    [[0, 0, 0, ...], [0, 0, 1, ...], ...]
+  ],
+  "boxes": [
+    [120, 80, 300, 450],
+    [400, 200, 600, 500]
+  ],
+  "scores": [0.95, 0.87]
+}
+```
+
+## 常见问题
+
+### 拖拽附件后提示找不到文件？
+
+这是 stdio MCP 的已知限制。当通过 Agent 界面拖拽或上传附件时，文件路径通常不会自动传给 MCP Server。
+
+**解决方法：**
+
+1. **同时提供路径**（推荐）：拖拽图片后，在文字中补充说明图片的本地绝对路径：
+   > "请处理这张图片 `D:\\photos\\cat.jpg`，找出里面的猫"
+
+2. **等待自动编码**：Claude 可能会自动将图片编码为 base64 传入。如果成功，无需额外操作。
+
+3. **回答路径询问**：如果 Claude 询问图片路径，直接回复本地绝对路径即可。
+
+### 三种输入方式有优先级吗？
+
+没有严格优先级。Claude 会根据对话上下文自动选择最合适的方式：
+
+- 你提供了本地路径 → 使用 `imagePath`
+- 你提供了网络链接 → 使用 `imageUrl`
+- 你拖拽了附件且没有路径 → 尝试 `imageBase64`
+
+### 支持哪些图片格式？
+
+支持常见格式：PNG、JPG、JPEG、BMP、WebP 等。建议优先使用 PNG 或 JPG。
+
+### URL 图片下载失败怎么办？
+
+确保 URL 是**公开可访问**的，不需要登录、Cookie 或签名。如果图片在需要身份验证的服务上（如私有 S3 Bucket、需要登录的图床），请先下载到本地再使用 `imagePath`。
+
+### Base64 图片太大怎么办？
+
+如果图片很大（如 4K 分辨率），base64 编码后的数据会非常大，可能导致传输变慢。建议：
+
+1. 使用 `imagePath` 代替
+2. 或先将图片压缩后再编码
+
+## 文件上传说明
+
+当 `type` 为 `"local"` 时，MCP Server 会：
+1. 读取本地文件
+2. 通过预签名 URL 直传到 TOS 对象存储
+3. **最大文件大小：100MB**
+
+## 故障排查
+
+### "command not found: npx"
+
+安装 Node.js >= 18：https://nodejs.org/
+
+### "错误: 需要提供 --api-key 或设置 API_KEY"
+
+API Key 缺失，请检查配置中的 `env.API_KEY`。
+
+### MCP Server 在客户端显示红色/错误
+
+查看日志：
+- **Claude Desktop macOS**：`~/Library/Logs/Claude/mcp*.log`
+- **Claude Desktop Windows**：`%APPDATA%\Claude\logs\mcp*.log`
+- **Cursor**：Output 面板 > MCP
+
+### "TOS 上传失败"
+
+通常是签名不匹配，请确认 `HTTP_API_BASE_URL` 和 `HTTP_API_KEY` 正确且有效。
+
+## 全局安装（可选）
+
+如果你不想每次都用 `npx`：
+
+```bash
+npm install -g @avclabs.ai/media-mcp
+```
+
+然后在配置中使用 `"command": "media-mcp"` 配合 `"args": ["--api-key", "your-api-key"]` 。
+
+## License
+
+MIT License - 详见 [LICENSE](LICENSE) 文件

package/README_EN.md

@@ -0,0 +1,332 @@
+# media-mcp (Node.js)
+
+[中文](https://github.com/avclabs/media-mcp/blob/main/README.md) | English
+
+[![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 and image segmentation service based on the MCP protocol, acting as an MCP Client-Server to interact with backend HTTP Servers.
+
+## Features
+
+Provides the following MCP Tools:
+- `create_task` - Create a video enhancement task (supports URL or local file upload)
+- `get_task_status` - Query task status
+- `enhance_video_sync` - Synchronously enhance video (blocking wait)
+- `sam3_predict` - SAM3 image segmentation (supports local path, URL, or Base64 image)
+
+## Prerequisites
+
+- **Node.js >= 18** (check: `node --version`)
+- **API Key** (required for authentication)
+
+## Lazy Install (Recommended)
+
+If your AI Agent has a known MCP config path, just copy the line below and send it to your AI:
+
+```
+Install the npm package @avclabs.ai/media-mcp as an MCP server. My API Key is: sk-xxxxxxxx.
+```
+
+The AI will automatically:
+1. Detect your MCP client
+2. Find the config file path
+3. Write the correct configuration
+4. Prompt you to restart the client
+
+## Manual Install
+
+No installation needed. Use `npx` directly in your MCP client config.
+
+### 1. Claude Code (CLI)
+
+Run in Claude Code:
+
+```
+/mcp
+```
+
+Check the output for the **"User MCPs"** section to find the config file path, then edit that file.
+
+Common paths (if `/mcp` is unavailable):
+- **Windows**: `%USERPROFILE%\.claude.json`
+- **macOS**: `~/.claude.json`
+- **Linux**: `~/.claude.json`
+- **Legacy/Alternative**: `~/.claude/mcp.json`
+
+Paste this (replace `your-api-key`):
+
+```json
+{
+  "mcpServers": {
+    "video-enhancement": {
+      "command": "npx",
+      "args": ["-y", "@avclabs.ai/media-mcp@latest"],
+      "env": {
+        "API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+Save and run `/mcp` to verify it's loaded.
+
+### 2. Cursor
+
+Go to **Settings > Tools & MCPs > Add New MCP Server**:
+
+- **Name**: `video-enhancement`
+- **Type**: `command`
+- **Command**:
+  ```bash
+  env HTTP_API_KEY=your-api-key npx -y @avclabs.ai/media-mcp@latest
+  ```
+
+Or edit `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "video-enhancement": {
+      "command": "npx",
+      "args": ["-y", "@avclabs.ai/media-mcp@latest"],
+      "env": {
+        "API_KEY": "your-api-key"
+      }
+    }
+  }
+}
+```
+
+## Verify Installation
+
+After restarting your client, check if the tools are available:
+
+1. Or ask: "What tools do you have available?"
+2. You should see: `create_task`, `get_task_status`, `enhance_video_sync`, `sam3_predict`
+
+## Configuration Options
+
+| Variable | Required | Default | Description |
+|---|---|---|---|
+| `API_KEY` | **Yes** | - | API authentication key (shared by video enhancement and SAM3) |
+| `HTTP_API_BASE_URL` | No | `https://mcp.avc.ai/enhance` | Video enhancement service endpoint |
+| `SAM3_API_BASE_URL` | No | `https://mcp.avc.ai/sam` | SAM3 service endpoint |
+| `SAM3_POLL_INTERVAL` | No | `2000` | Polling interval (milliseconds) |
+| `SAM3_POLL_MAX_ATTEMPTS` | No | `60` | Maximum polling attempts |
+
+### Custom Endpoint
+
+```json
+{
+  "env": {
+    "HTTP_API_BASE_URL": "https://your-endpoint.com",
+    "HTTP_API_KEY": "your-api-key"
+  }
+}
+```
+
+Or via CLI args:
+```bash
+npx -y @avclabs.ai/media-mcp@latest --base-url https://your-endpoint.com --api-key your-api-key --sam3-base-url http://localhost:8001 --sam3-api-key your-sam3-key
+```
+
+## Usage Examples
+
+Once configured, ask your AI agent naturally:
+
+> "Enhance this video to 1080p: https://example.com/video.mp4"
+
+> "Improve the quality of /Users/me/Desktop/video.mp4 to 2k"
+
+The agent will automatically call the appropriate tools.
+
+> "Analyze this image and find all objects: C:\Users\xxx\photo.png"
+>
+> "Use SAM3 to segment this image, prompt: 'find all cars'"
+
+## Provided Tools
+
+### create_task
+
+Create an asynchronous video enhancement task.
+
+| Parameter | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `video_source` | string | Yes | - | Video URL or local file path (URL must be publicly accessible, links requiring login or signatures are not supported) |
+| `type` | string | No | `url` | `url` or `local` |
+| `resolution` | string | No | `720p` | `480p`, `540p`, `720p`, `1080p`, `2k` |
+
+**Returns:**
+```json
+{
+  "success": true,
+  "task_id": "xxx",
+  "status": "wait"
+}
+```
+
+### get_task_status
+
+Query task status.
+
+| Parameter | Type | Required |
+|---|---|---|
+| `task_id` | string | Yes |
+
+**Returns:**
+```json
+{
+  "success": true,
+  "task_id": "xxx",
+  "status": "completed",
+  "progress": 100,
+  "video_url": "https://..."
+}
+```
+
+### enhance_video_sync
+
+Synchronously enhance video (blocks until completion).
+
+| Parameter | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `video_source` | string | Yes | - | Video URL or local file path (URL must be publicly accessible, links requiring login or signatures are not supported) |
+| `type` | string | No | `url` | `url` or `local` |
+| `resolution` | string | No | `720p` | Target resolution |
+| `poll_interval` | number | No | `5` | Poll interval (seconds) |
+| `timeout` | number | No | `600` | Timeout (seconds) |
+
+### sam3_predict
+
+Analyze an image using the SAM3 segmentation API to generate inference results (masks, boxes, scores).
+
+**Parameters:**
+
+Image input (choose one, must provide exactly one):
+
+- `imagePath` (string): Absolute path of a local image file. Supports common formats (PNG, JPG, JPEG, BMP, WebP).
+  - Example: `"C:\\Users\\xxx\\photo.png"`, `"/home/user/images/cat.jpg"`
+  - Use when: The user explicitly provides a local file path
+
+- `imageUrl` (string): Publicly accessible URL of the image.
+  - Example: `"https://example.com/photo.jpg"`
+  - Use when: The image is already online and the user provides a link
+  - Note: The URL must be publicly accessible. Links requiring login or signatures are not supported
+
+- `imageBase64` (string): Base64-encoded image data.
+  - Example: `"iVBORw0KGgoAAAANSUhEUgAA..."`
+  - Use when: The user drags or uploads an image attachment, and the Agent encodes it as base64
+  - Note: Large images will produce very large base64 strings, which may slow transmission
+
+Other parameters:
+
+- `prompt` (string, required): English text prompt specifying the target object to segment. Examples: `"person"`, `"car"`, `"a cat sitting on a sofa"`. Since the SAM3 model only accepts English prompts, provide an English description. If the user provides Chinese or other non-English text, the Agent will automatically translate it before calling the tool.
+
+**Returns:**
+
+After inference completes, returns a JSON string containing three fields:
+
+- **`masks`**: 2D array. Each element is a binary mask (values 0 or 1) with the same dimensions as the input image, marking the pixel-level location of detected objects. The i-th mask corresponds to the i-th detected object instance.
+- **`boxes`**: 2D array. Each element is a bounding box in `[x1, y1, x2, y2]` format, representing the rectangular region of the detected object. `x1`, `y1` are the top-left coordinates; `x2`, `y2` are the bottom-right coordinates.
+
+  Coordinate system: The top-left corner of the image is the origin `(0, 0)`. The x-axis increases to the right, and the y-axis increases downward, in pixels. For example, `[120, 80, 300, 450]` means the region starts 120px from the left edge and 80px from the top edge, extending to 300px from the left and 450px from the top. Width = `x2 - x1 = 180px`, Height = `y2 - y1 = 370px`.
+- **`scores`**: 1D array. Each element is a confidence score for the corresponding detection result, ranging from 0 to 1. Higher scores indicate greater model confidence.
+
+Example result JSON:
+
+```json
+{
+  "masks": [
+    [[0, 0, 1, ...], [0, 1, 1, ...], ...],
+    [[0, 0, 0, ...], [0, 0, 1, ...], ...]
+  ],
+  "boxes": [
+    [120, 80, 300, 450],
+    [400, 200, 600, 500]
+  ],
+  "scores": [0.95, 0.87]
+}
+```
+
+## FAQ
+
+### Drag-and-drop attachment says file not found?
+
+This is a known limitation of stdio MCP. When dragging or uploading an attachment through the Agent interface, the file path is usually not automatically passed to the MCP Server.
+
+**Solutions:**
+
+1. **Provide the path simultaneously** (recommended): After dragging the image,补充 the local absolute path in your message:
+   > "Please analyze this image `D:\\photos\\cat.jpg` and find the cat"
+
+2. **Wait for auto-encoding**: Claude may automatically encode the image as base64. If successful, no extra action is needed.
+
+3. **Reply to path inquiry**: If Claude asks for the image path, simply reply with the local absolute path.
+
+### Is there a priority among the three input methods?
+
+There is no strict priority. Claude will automatically choose the most appropriate method based on conversation context:
+
+- You provided a local path → uses `imagePath`
+- You provided a web link → uses `imageUrl`
+- You dragged an attachment without a path → tries `imageBase64`
+
+### What image formats are supported?
+
+Common formats: PNG, JPG, JPEG, BMP, WebP, etc. PNG or JPG is recommended.
+
+### What if URL image download fails?
+
+Ensure the URL is **publicly accessible**, requiring no login, cookies, or signatures. If the image is on a service requiring authentication (e.g., private S3 Bucket, login-required image host), download it locally first and use `imagePath`.
+
+### What if the base64 image is too large?
+
+If the image is very large (e.g., 4K resolution), the base64-encoded data will be very large and may slow transmission. Suggestions:
+
+1. Use `imagePath` instead
+2. Or compress the image before encoding
+
+## File Upload Notes
+
+When `type` is `"local"`:
+1. File is read locally by the MCP Server
+2. Uploaded directly to TOS object storage via pre-signed URL
+3. **Max file size: 100MB**
+
+## Troubleshooting
+
+### "command not found: npx"
+
+Install Node.js >= 18: https://nodejs.org/
+
+### "Error:需要提供 --api-key 或设置 HTTP_API_KEY"
+
+Your API Key is missing. Double-check the `env.HTTP_API_KEY` in your config.
+
+### MCP Server shows red/error in client
+
+Check logs:
+- **Claude Desktop macOS**: `~/Library/Logs/Claude/mcp*.log`
+- **Claude Desktop Windows**: `%APPDATA%\Claude\logs\mcp*.log`
+- **Cursor**: Output panel > MCP
+
+### "TOS 上传失败"
+
+Usually a signature mismatch. Ensure your `HTTP_API_BASE_URL` and `HTTP_API_KEY` are correct and active.
+
+## Global Install (Alternative)
+
+If you prefer not using `npx` every time:
+
+```bash
+npm install -g @avclabs.ai/media-mcp
+```
+
+Then use `"command": "media-mcp"` with `"args": ["--api-key", "your-api-key"]` in your config.
+
+## License
+
+MIT License - See [LICENSE](LICENSE) file for details

package/config.json

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

package/dist/sam3.d.ts

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

package/dist/sam3.d.ts.map

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

package/dist/sam3.js

@@ -0,0 +1,154 @@
+import axios from 'axios';
+import * as fs from 'fs';
+import * as path from 'path';
+import { z } from 'zod';
+import FormData from 'form-data';
+const Sam3PredictSchema = z.object({
+    imagePath: z.string().optional().describe('Absolute path of a local image file (e.g. C:\\\\Users\\\\xxx\\\\photo.png)'),
+    imageUrl: z.string().url().optional().describe('Publicly accessible URL of the image to process'),
+    imageBase64: z.string().optional().describe('Base64-encoded image data. Use this when the image is provided as an attachment without a local path'),
+    prompt: z.string().describe('Text prompt for mask generation. Must be in English. If the user provides Chinese or other non-English text, translate it to English before calling this tool'),
+});
+export function setupSam3Tools(server, baseUrl, apiKey, pollInterval, pollMaxAttempts) {
+    const client = axios.create({
+        baseURL: baseUrl.replace(/\/$/, ''),
+        headers: {
+            'X-API-Key': apiKey,
+            'Content-Type': 'application/json',
+        },
+        timeout: 60000,
+    });
+    server.tool('sam3_predict', `Analyze an image using the SAM3 segmentation API to generate inference results (masks, boxes, scores).
+The image can be provided in one of three ways:
+1. imagePath: Absolute path of a local image file (e.g. C:\\Users\\xxx\\photo.png). Use this when the user provides a local file path.
+2. imageUrl: Publicly accessible URL of the image (e.g. https://example.com/photo.jpg). Use this when the user provides a web link.
+3. imageBase64: Base64-encoded image data. Use this when the user uploads or drags-and-drops an image as an attachment and no local path is available.
+In this case, encode the image content as base64 and pass it via this parameter.
+If the user mentions an uploaded image but does not provide a path, URL, or base64 data, ask the user for the local absolute path.
+Prompt must be in English. If the user provides Chinese or other non-English text, translate it to English before calling this tool.`, Sam3PredictSchema.shape, async (args) => {
+        try {
+            if (!apiKey) {
+                throw new Error('SAM3 API Key not configured. Please set API_KEY environment variable or --api-key argument.');
+            }
+            const result = await sam3PredictTool(client, pollInterval, pollMaxAttempts, args);
+            return {
+                content: [{ type: 'text', text: result }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ success: false, error: errorMessage }, null, 2) }],
+            };
+        }
+    });
+}
+async function getSam3PostSignature(client, fileName) {
+    const response = await client.post('/get_postsignature_url', {
+        file_type: 'image',
+        file_name: fileName,
+    });
+    const data = response.data;
+    if (data.code !== 0) {
+        throw new Error(`get_postsignature_url error: ${data.message || 'unknown error'}`);
+    }
+    return data.data;
+}
+async function uploadImageToTos(url, sigData, tosKey, buffer, fileName) {
+    const formData = new FormData();
+    formData.append('key', tosKey);
+    formData.append('policy', sigData.policy);
+    formData.append('x-tos-algorithm', sigData.algorithm);
+    formData.append('x-tos-credential', sigData.credential);
+    formData.append('x-tos-date', sigData.date);
+    formData.append('x-tos-signature', sigData.signature);
+    formData.append('file', buffer, fileName);
+    const response = await axios.post(url, formData, {
+        headers: formData.getHeaders(),
+        maxBodyLength: Infinity,
+        maxContentLength: Infinity,
+    });
+    if (response.status >= 400) {
+        throw new Error(`TOS upload failed: ${response.status} ${response.statusText}`);
+    }
+}
+async function sam3Predict(client, fileId, prompt) {
+    const response = await client.post('/predict', { file_id: fileId, prompt });
+    return response.data.task_id;
+}
+async function getSam3PredictResult(client, taskId, pollInterval, pollMaxAttempts) {
+    for (let attempt = 0; attempt < pollMaxAttempts; attempt++) {
+        const response = await client.get(`/predict/result/${encodeURIComponent(taskId)}`);
+        const data = response.data;
+        if (data.status === 'completed') {
+            return data;
+        }
+        if (data.status === 'failed') {
+            throw new Error(`Task failed: ${data.error_message || 'unknown error'}`);
+        }
+        await sleep(pollInterval);
+    }
+    throw new Error('Polling timeout: task did not complete in time');
+}
+async function downloadSam3Result(url) {
+    const response = await axios.get(url);
+    return response.data;
+}
+async function sam3PredictTool(client, pollInterval, pollMaxAttempts, args) {
+    const { imagePath, imageUrl, imageBase64, prompt } = args;
+    if (!imagePath && !imageUrl && !imageBase64) {
+        throw new Error('Missing image input: must provide one of imagePath, imageUrl, or imageBase64');
+    }
+    if (!prompt) {
+        throw new Error('Missing argument: prompt');
+    }
+    let buffer;
+    let fileName;
+    if (imagePath) {
+        if (!fs.existsSync(imagePath)) {
+            throw new Error(`Local file does not exist: ${imagePath}`);
+        }
+        fileName = path.basename(imagePath);
+        buffer = fs.readFileSync(imagePath);
+    }
+    else if (imageUrl) {
+        const response = await axios.get(imageUrl, { responseType: 'arraybuffer' });
+        buffer = Buffer.from(response.data);
+        fileName = path.basename(new URL(imageUrl).pathname) || 'image.png';
+    }
+    else if (imageBase64) {
+        buffer = Buffer.from(imageBase64, 'base64');
+        fileName = 'image.png';
+    }
+    else {
+        throw new Error('Missing image input: must provide one of imagePath, imageUrl, or imageBase64');
+    }
+    // Step 1: Get post signature
+    const signatureData = await getSam3PostSignature(client, fileName);
+    const { url, origin_policy } = signatureData;
+    if (!url) {
+        throw new Error('Missing upload URL in post signature response');
+    }
+    // Parse key from origin_policy
+    const keyObj = JSON.parse(origin_policy).conditions.find((c) => 'key' in c);
+    const tosKey = keyObj ? keyObj.key : new URL(url).pathname.slice(1);
+    // Parse file_id from url path
+    const fileId = new URL(url).pathname.split('/').pop();
+    if (!fileId) {
+        throw new Error('Could not extract file_id from upload URL');
+    }
+    // Step 2: Upload to TOS
+    await uploadImageToTos(url, signatureData, tosKey, buffer, fileName);
+    // Step 3: Create predict task
+    const taskId = await sam3Predict(client, fileId, prompt);
+    // Step 4: Poll for result
+    const taskResult = await getSam3PredictResult(client, taskId, pollInterval, pollMaxAttempts);
+    // Step 5: Download result JSON and return as string
+    const resultUrl = taskResult.result;
+    const resultJson = await downloadSam3Result(resultUrl);
+    return JSON.stringify(resultJson, null, 2);
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=sam3.js.map

package/dist/sam3.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * MCP Server - 提供视频增强和 SAM3 图像分割功能
+ */
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

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

package/dist/server.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+/**
+ * MCP Server - 提供视频增强和 SAM3 图像分割功能
+ */
+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' };
+}
+// 主入口
+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 || '60', 10);
+    // 解析命令行参数
+    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('错误: 需要提供 --api-key 或设置 API_KEY 环境变量');
+        process.exit(1);
+    }
+    const server = new McpServer({
+        name: 'media-mcp',
+        version: '0.3.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // 注册视频增强 tools
+    setupVideoEnhancementTools(server, baseUrl, apiKey);
+    // 注册 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);
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AACA;;GAEG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,KAAK,CAAC;AACpC,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AAE3C,SAAS,UAAU;IACjB,MAAM,WAAW,GAAG;QAClB,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,CAAC;QAC1C,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,aAAa,CAAC;KAC7C,CAAC;IACF,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;QACrC,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;gBAChE,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,4BAA4B;oBACvD,WAAW,EAAE,MAAM,CAAC,WAAW,IAAI,wBAAwB;iBAC5D,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,4BAA4B,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;AAC1F,CAAC;AAED,MAAM;AACN,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,MAAM,CAAC,OAAO,CAAC;IAC9D,IAAI,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;IACvC,IAAI,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,MAAM,CAAC,WAAW,CAAC;IACtE,IAAI,UAAU,GAAG,MAAM,CAAC;IACxB,IAAI,gBAAgB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9E,IAAI,mBAAmB,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IAEnF,UAAU;IACV,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,YAAY,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACpD,OAAO,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACtB,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAC1D,MAAM,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACrB,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,iBAAiB,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YAChE,WAAW,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC1B,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,sBAAsB,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACrE,gBAAgB,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7C,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,0BAA0B,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;YACzE,mBAAmB,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAChD,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IAED,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,OAAO;KACjB,EACD;QACE,YAAY,EAAE;YACZ,KAAK,EAAE,EAAE;SACV;KACF,CACF,CAAC;IAEF,eAAe;IACf,0BAA0B,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAEpD,gBAAgB;IAChB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,gBAAgB,EAAE,mBAAmB,CAAC,CAAC;IAEvF,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;AAC/C,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/dist/video-enhancement.d.ts

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

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

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

package/dist/video-enhancement.js

@@ -0,0 +1,225 @@
+import axios from 'axios';
+import * as fs from 'fs';
+import * as path from 'path';
+import { z } from 'zod';
+import FormData from 'form-data';
+// Schemas
+const CreateTaskSchema = z.object({
+    video_source: z.string().describe('视频URL地址或本地文件路径（URL必须公网可访问，不支持需要登录或签名的链接）'),
+    type: z.enum(['url', 'local']).default('url').describe('上传类型：url=网络视频，local=本地文件'),
+    resolution: z.enum(['480p', '540p', '720p', '1080p', '2k']).default('720p').describe('目标分辨率，默认720p'),
+});
+const GetTaskStatusSchema = z.object({
+    task_id: z.string().describe('任务ID'),
+});
+const EnhanceVideoSyncSchema = z.object({
+    video_source: z.string().describe('视频URL地址或本地文件路径（URL必须公网可访问，不支持需要登录或签名的链接）'),
+    type: z.enum(['url', 'local']).default('url').describe('上传类型：url=网络视频，local=本地文件'),
+    resolution: z.enum(['480p', '540p', '720p', '1080p', '2k']).default('720p').describe('目标分辨率，默认720p'),
+    poll_interval: z.number().default(5).describe('轮询间隔（秒），默认5'),
+    timeout: z.number().default(600).describe('超时时间（秒），默认600'),
+});
+export function setupVideoEnhancementTools(server, baseUrl, apiKey) {
+    const client = axios.create({
+        baseURL: baseUrl.replace(/\/$/, ''),
+        headers: {
+            'Authorization': `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+        },
+        timeout: 60000,
+    });
+    // create_task tool
+    server.tool('create_task', `创建视频增强任务（异步）
+
+支持两种上传方式：
+1. URL 上传：提供视频 URL
+2. 本地上传：提供本地文件路径，MCP Server 自动上传到 TOS 对象存储
+
+参数说明：
+- video_source: 视频 URL 或本地文件路径
+- type: "url" 或 "local"
+- resolution: 目标分辨率`, CreateTaskSchema.shape, async (args) => {
+        try {
+            const result = await createTask(client, args.video_source, args.type, args.resolution);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ success: false, error: errorMessage }, null, 2) }],
+            };
+        }
+    });
+    // get_task_status tool
+    server.tool('get_task_status', '查询视频增强任务状态', GetTaskStatusSchema.shape, async (args) => {
+        try {
+            const result = await getTaskStatus(client, args.task_id);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ success: false, error: errorMessage }, null, 2) }],
+            };
+        }
+    });
+    // enhance_video_sync tool
+    server.tool('enhance_video_sync', `同步增强视频（阻塞等待完成）
+
+支持两种上传方式：
+1. URL 上传：提供视频 URL
+2. 本地上传：提供本地文件路径，MCP Server 自动上传到 TOS 对象存储
+
+参数说明：
+- video_source: 视频 URL 或本地文件路径
+- type: "url" 或 "local"
+- resolution: 目标分辨率
+- poll_interval: 轮询间隔（秒）
+- timeout: 超时时间（秒）`, EnhanceVideoSyncSchema.shape, async (args) => {
+        try {
+            const result = await enhanceVideoSync(client, args.video_source, args.type, args.resolution, args.poll_interval, args.timeout);
+            return {
+                content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ success: false, error: errorMessage }, null, 2) }],
+            };
+        }
+    });
+}
+function checkLocalFile(filePath) {
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`文件不存在: ${filePath}`);
+    }
+    const stats = fs.statSync(filePath);
+    const maxSize = 100 * 1024 * 1024;
+    if (stats.size > maxSize) {
+        throw new Error('文件大小超过 100MB 限制');
+    }
+    return { filePath, fileName: path.basename(filePath) };
+}
+async function getTosSignature(client, fileName) {
+    const response = await client.post('/api/v3/contents/generations/tos-signature', {
+        file_type: 'video',
+        file_name: fileName,
+    });
+    const data = response.data;
+    if (data.code !== 0 && data.code !== 200) {
+        throw new Error(data.message || '获取 TOS 签名失败');
+    }
+    return data.data;
+}
+async function uploadToTos(filePath, signatureData) {
+    const formData = new FormData();
+    const objectKey = decodeURIComponent(new URL(signatureData.url).pathname.slice(1));
+    formData.append('key', objectKey);
+    const fieldMapping = {
+        algorithm: 'x-tos-algorithm',
+        credential: 'x-tos-credential',
+        date: 'x-tos-date',
+        signature: 'x-tos-signature',
+    };
+    for (const [key, value] of Object.entries(signatureData)) {
+        if (key === 'url' || key === 'origin_policy')
+            continue;
+        const formKey = fieldMapping[key] || key;
+        formData.append(formKey, String(value));
+    }
+    const fileName = path.basename(filePath);
+    formData.append('file', fs.createReadStream(filePath), fileName);
+    const response = await axios.post(signatureData.url, formData, {
+        headers: formData.getHeaders(),
+        maxBodyLength: Infinity,
+        maxContentLength: Infinity,
+    });
+    if (response.status >= 400) {
+        const debugInfo = JSON.stringify({
+            status: response.status,
+            statusText: response.statusText,
+            data: response.data,
+            url: signatureData.url,
+            signatureFields: Object.keys(signatureData),
+            fileName,
+            fileSize: fs.statSync(filePath).size,
+        }, null, 2);
+        throw new Error(`TOS 上传失败: ${response.status} ${response.statusText}\n调试信息: ${debugInfo}`);
+    }
+}
+function parseFileIdFromUrl(url) {
+    const pathname = new URL(url).pathname;
+    const segments = pathname.split('/');
+    return decodeURIComponent(segments.pop() || '');
+}
+async function createTask(client, videoSource, sourceType, resolution) {
+    let contentItem;
+    if (sourceType === 'local') {
+        const fileInfo = checkLocalFile(videoSource);
+        const signatureData = await getTosSignature(client, fileInfo.fileName);
+        await uploadToTos(videoSource, signatureData);
+        const fileId = parseFileIdFromUrl(signatureData.url);
+        contentItem = { type: 'video_file', file_id: fileId, file_name: fileInfo.fileName };
+    }
+    else {
+        contentItem = { type: 'video_url', video_url: { url: videoSource } };
+    }
+    const payload = { model: 'avc-enhance', content: [contentItem], resolution };
+    const response = await client.post('/api/v3/contents/generations/tasks', payload);
+    const data = response.data;
+    if (data.code !== 0 && data.code !== 200) {
+        return { success: false, error: data.message };
+    }
+    return { success: true, task_id: data.data.task_id, status: data.data.status };
+}
+async function getTaskStatus(client, taskId) {
+    const response = await client.get(`/api/v3/contents/generations/tasks/${taskId}`);
+    const data = response.data;
+    if (data.code !== 0 && data.code !== 200) {
+        return { success: false, error: data.message };
+    }
+    const result = data.data;
+    return {
+        success: true,
+        task_id: result.task_id,
+        status: result.status,
+        progress: result.progress || 0,
+        video_url: result.video_url,
+        debug_video_url_length: result.video_url?.length,
+        debug_video_url_full: result.video_url,
+        error_message: result.error_message,
+        created_at: result.created_at,
+        updated_at: result.updated_at,
+    };
+}
+async function enhanceVideoSync(client, videoSource, sourceType, resolution, pollInterval, timeout) {
+    const createResult = await createTask(client, videoSource, sourceType, resolution);
+    if (!createResult.success) {
+        return createResult;
+    }
+    const taskId = createResult.task_id;
+    const startTime = Date.now();
+    while (true) {
+        const status = await getTaskStatus(client, taskId);
+        if (!status.success) {
+            return status;
+        }
+        if (status.status === 'completed' || status.status === 'failed') {
+            return status;
+        }
+        const elapsed = (Date.now() - startTime) / 1000;
+        if (elapsed >= timeout) {
+            return { success: false, error: `任务超时: ${taskId}`, task_id: taskId };
+        }
+        await sleep(pollInterval * 1000);
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=video-enhancement.js.map

package/dist/video-enhancement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"video-enhancement.js","sourceRoot":"","sources":["../src/video-enhancement.ts"],"names":[],"mappings":"AACA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,QAAQ,MAAM,WAAW,CAAC;AAEjC,UAAU;AACV,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IAC7E,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAClF,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;CACrG,CAAC,CAAC;AAEH,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;CACrC,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,0CAA0C,CAAC;IAC7E,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IAClF,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;IACpG,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC;IAC5D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,eAAe,CAAC;CAC3D,CAAC,CAAC;AAEH,MAAM,UAAU,0BAA0B,CAAC,MAAiB,EAAE,OAAe,EAAE,MAAc;IAC3F,MAAM,MAAM,GAAkB,KAAK,CAAC,MAAM,CAAC;QACzC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;QACnC,OAAO,EAAE;YACP,eAAe,EAAE,UAAU,MAAM,EAAE;YACnC,cAAc,EAAE,kBAAkB;SACnC;QACD,OAAO,EAAE,KAAK;KACf,CAAC,CAAC;IAEH,mBAAmB;IACnB,MAAM,CAAC,IAAI,CACT,aAAa,EACb;;;;;;;;;oBASgB,EAChB,gBAAgB,CAAC,KAAK,EACtB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;YACvF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACpG,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,uBAAuB;IACvB,MAAM,CAAC,IAAI,CACT,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,CAAC,KAAK,EACzB,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YACzD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACpG,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,0BAA0B;IAC1B,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB;;;;;;;;;;;mBAWe,EACf,sBAAsB,CAAC,KAAK,EAC5B,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CACnC,MAAM,EACN,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,UAAU,EACf,IAAI,CAAC,aAAa,EAClB,IAAI,CAAC,OAAO,CACb,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACnE,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;aACpG,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,QAAgB;IACtC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,UAAU,QAAQ,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC;IAClC,IAAI,KAAK,CAAC,IAAI,GAAG,OAAO,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;AACzD,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,MAAqB,EAAE,QAAgB;IACpE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,4CAA4C,EAAE;QAC/E,SAAS,EAAE,OAAO;QAClB,SAAS,EAAE,QAAQ;KACpB,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,OAAO,IAAI,aAAa,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,aAAkB;IAC7D,MAAM,QAAQ,GAAG,IAAI,QAAQ,EAAE,CAAC;IAChC,MAAM,SAAS,GAAG,kBAAkB,CAAC,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;IAElC,MAAM,YAAY,GAA2B;QAC3C,SAAS,EAAE,iBAAiB;QAC5B,UAAU,EAAE,kBAAkB;QAC9B,IAAI,EAAE,YAAY;QAClB,SAAS,EAAE,iBAAiB;KAC7B,CAAC;IAEF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACzD,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,eAAe;YAAE,SAAS;QACvD,MAAM,OAAO,GAAG,YAAY,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;QACzC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEjE,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE;QAC7D,OAAO,EAAE,QAAQ,CAAC,UAAU,EAAE;QAC9B,aAAa,EAAE,QAAQ;QACvB,gBAAgB,EAAE,QAAQ;KAC3B,CAAC,CAAC;IAEH,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YAC/B,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,IAAI,EAAE,QAAQ,CAAC,IAAI;YACnB,GAAG,EAAE,aAAa,CAAC,GAAG;YACtB,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;YAC3C,QAAQ;YACR,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI;SACrC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,aAAa,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,WAAW,SAAS,EAAE,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAW;IACrC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC;IACvC,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACrC,OAAO,kBAAkB,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,MAAqB,EACrB,WAAmB,EACnB,UAAkB,EAClB,UAAkB;IAElB,IAAI,WAAgB,CAAC;IAErB,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;QAC7C,MAAM,aAAa,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACvE,MAAM,WAAW,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,kBAAkB,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QACrD,WAAW,GAAG,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;IACtF,CAAC;SAAM,CAAC;QACN,WAAW,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE,CAAC;IACvE,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC7E,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,oCAAoC,EAAE,OAAO,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAE3B,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;QACzC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;AACjF,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,MAAqB,EAAE,MAAc;IAChE,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,sCAAsC,MAAM,EAAE,CAAC,CAAC;IAClF,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;IAE3B,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;QACzC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;IACjD,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC;IACzB,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,CAAC;QAC9B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,sBAAsB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM;QAChD,oBAAoB,EAAE,MAAM,CAAC,SAAS;QACtC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,MAAqB,EACrB,WAAmB,EACnB,UAAkB,EAClB,UAAkB,EAClB,YAAoB,EACpB,OAAe;IAEf,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC;IACnF,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;QAC1B,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC;IACpC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAChE,OAAO,MAAM,CAAC;QAChB,CAAC;QACD,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC;QAChD,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;YACvB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QACvE,CAAC;QACD,MAAM,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "type": "module",
+  "name": "@avclabs.ai/media-mcp",
+  "version": "0.1.0",
+  "description": "MCP Server for video enhancement and image segmentation (SAM3)",
+  "mcpName": "io.github.avclabs/media-mcp",
+  "main": "dist/server.js",
+  "types": "dist/server.d.ts",
+  "bin": {
+    "media-mcp": "dist/server.js"
+  },
+  "files": [
+    "dist",
+    "config.json",
+    "LICENSE",
+    "README.md",
+    "README_EN.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "video",
+    "enhancement",
+    "http",
+    "client",
+    "server",
+    "claude",
+    "anthropic"
+  ],
+  "author": "Your Name <your.email@example.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/avclabs/media-mcp.git"
+  },
+  "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"
+  },
+  "mcpServer": {
+    "command": "npx",
+    "args": [
+      "-y",
+      "@avclabs.ai/media-mcp@latest"
+    ],
+    "env": {
+      "API_KEY": "your-api-key",
+      "HTTP_API_BASE_URL": "https://mcp.avc.ai/enhance",
+      "SAM3_API_BASE_URL": "https://mcp.avc.ai/sam"
+    },
+    "description": "视频增强 + SAM3 图像分割 MCP 服务",
+    "setup": "需要替换 env.API_KEY 为你的 API Key"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}