Avc Test Py Mcp

io.github.z416479660由 GitHub 账号 z416479660 发布v1.0.0更新于 Oct 27, 2026

MCP server for video enhancement (create_task, get_task_status, enhance_video_sync)

已验证STDIO仅桌面媒体与设计AI 与机器学习

概览

AI 生成的概览

该 MCP 服务器让助手向远程 FastAPI 视频增强服务提交任务、查询进度，并获取增强后的视频链接。

可以做什么
  • 通过视频 URL 或本地文件路径创建增强任务，可指定 480p 至 2k 的目标分辨率
  • 按任务 ID 查询状态、进度、结果视频链接和错误信息
  • 以同步方式执行增强，按设定间隔轮询直到完成或超时
  • 将本地视频文件上传到增强服务，单文件最大 100MB
适用场景
适合需要让助手通过托管服务对视频文件或链接进行增强、放大，并取回处理结果链接的场景，可选择后台任务或阻塞式调用。
运行要求
以本地进程方式运行，可从 PyPI（pip 或 uv）或 npm 安装，并在 Claude Desktop 等桌面客户端中配置。需要设置 HTTP_API_BASE_URL（默认指向服务方地址）和必填的 HTTP_API_KEY 密钥，可通过命令行参数或环境变量传入。需要能访问该增强服务的网络。
安装前请注意
需要远程服务的 API 密钥（HTTP_API_KEY），不要写入共享配置文件。当 type 设为 "local" 时，本地文件会被读取、base64 编码并上传至第三方增强服务，请避免上传敏感视频。任务可能消耗付费额度，同步工具会阻塞直到完成或超时。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Avc Test Py Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

avc-test-py-mcp (Python)

[PyPI version] [Python 3.10+] [License: MIT]

基于 MCP 协议的视频增强服务，作为 MCP Client-Server 与 FastAPI HTTP Server 交互。

功能

提供以下 MCP Tools：

  • create_task - 创建视频增强任务（支持 URL 或本地文件上传）
  • get_task_status - 查询任务状态
  • enhance_video_sync - 同步增强视频（阻塞等待）

安装

从 PyPI 安装（推荐）

bash
# 使用 pip 安装pip install avc-test-py-mcp
# 或使用 uv 安装uv pip install avc-test-py-mcp

从源码安装

bash
git clone https://github.com/yourusername/avc-test-py-mcp.gitcd python_client
# 使用 uv 安装（推荐）uv pip install -e ".[dev]"
# 或使用 pip 安装pip install -e ".[dev]"

使用方法

1. 命令行启动

bash
# 直接运行（安装后）avc-test-py-mcp --base-url https://mcp.luluhero.com --api-key your-api-key
# 或使用环境变量export HTTP_API_BASE_URL=https://mcp.luluhero.comexport HTTP_API_KEY=your-api-keyavc-test-py-mcp

2. 在 Claude Desktop 中配置

编辑 Claude Desktop 配置文件：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%/Claude/claude_desktop_config.json

json
{  "mcpServers": {    "video-enhancement": {      "command": "avc-test-py-mcp",      "args": [        "--base-url",        "https://mcp.luluhero.com",        "--api-key",        "your-api-key"      ]    }  }}

3. 使用 uv run 运行（开发模式）

bash
uv run avc-test-py-mcp --base-url https://mcp.luluhero.com --api-key your-api-key

提供的 Tools

create_task

创建视频增强任务（异步）。

参数：

  • video_source (string, required): 视频 URL 或本地文件路径
  • type (string, optional): 上传类型，默认 "url"
    • 可选值: "url" - 网络视频URL, "local" - 本地文件路径
  • resolution (string, optional): 目标分辨率，默认 720p
    • 可选值: 480p, 540p, 720p, 1080p, 2k

使用示例：

python
# URL 方式{  "video_source": "https://example.com/video.mp4",  "type": "url",  "resolution": "1080p"}
# 本地文件方式{  "video_source": "/path/to/local/video.mp4",  "type": "local",  "resolution": "1080p"}

返回值：

json
{  "success": true,  "task_id": "xxx",  "status": "wait"}

get_task_status

查询任务状态。

参数：

  • task_id (string, required): 任务ID

使用示例：

python
{  "task_id": "task-123-abc"}

返回值：

json
{  "success": true,  "task_id": "xxx",  "status": "completed",  "progress": 100,  "video_url": "https://...",  "error_message": null,  "created_at": "2024-01-01T00:00:00Z",  "updated_at": "2024-01-01T00:01:00Z"}

enhance_video_sync

同步增强视频（阻塞等待完成）。

参数：

  • video_source (string, required): 视频 URL 或本地文件路径
  • type (string, optional): 上传类型，默认 "url"
    • 可选值: "url" - 网络视频URL, "local" - 本地文件路径
  • resolution (string, optional): 目标分辨率，默认 720p
  • poll_interval (number, optional): 轮询间隔（秒），默认 5
  • timeout (number, optional): 超时时间（秒），默认 600

使用示例：

python
{  "video_source": "https://example.com/video.mp4",  "type": "url",  "resolution": "1080p",  "poll_interval": 5,  "timeout": 600}

返回值：

json
{  "success": true,  "task_id": "xxx",  "status": "completed",  "progress": 100,  "video_url": "https://..."}

文件上传说明

当 type 设置为 "local" 时，MCP Server 会：

  1. 读取本地文件
  2. 将文件转为 base64 编码
  3. 上传到视频增强服务

限制：

  • 最大文件大小：100MB

环境变量

变量名说明默认值
HTTP_API_BASE_URLFastAPI HTTP Server 地址https://mcp.luluhero.com
HTTP_API_KEYAPI 认证密钥无

开发

bash
# 克隆仓库git clone https://github.com/yourusername/avc-test-py-mcp.gitcd python_client
# 安装开发依赖uv pip install -e ".[dev]"
# 运行测试pytest
# 代码格式化ruff format .ruff check --fix .

发布到 PyPI

bash
# 安装构建工具uv pip install build twine
# 构建分发包python -m build
# 上传到 PyPI（测试）python -m twine upload --repository testpypi dist/*
# 上传到 PyPI（正式）python -m twine upload dist/*

License

MIT License - 详见 LICENSE 文件

来源：README.md，提交 e569a16

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分