{
  "markdown": "<!-- mcp-name: io.github.z416479660/avc-test-py-mcp -->\n\n# avc-test-py-mcp (Python)\n\n[![PyPI version](https://badge.fury.io/py/avc-test-py-mcp.svg)](https://pypi.org/project/avc-test-py-mcp/)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n基于 MCP 协议的视频增强服务，作为 MCP Client-Server 与 FastAPI HTTP Server 交互。\n\n## 功能\n\n提供以下 MCP Tools：\n- `create_task` - 创建视频增强任务（支持 URL 或本地文件上传）\n- `get_task_status` - 查询任务状态\n- `enhance_video_sync` - 同步增强视频（阻塞等待）\n\n## 安装\n\n### 从 PyPI 安装（推荐）\n\n```bash\n# 使用 pip 安装\npip install avc-test-py-mcp\n\n# 或使用 uv 安装\nuv pip install avc-test-py-mcp\n```\n\n### 从源码安装\n\n```bash\ngit clone https://github.com/yourusername/avc-test-py-mcp.git\ncd python_client\n\n# 使用 uv 安装（推荐）\nuv pip install -e \".[dev]\"\n\n# 或使用 pip 安装\npip install -e \".[dev]\"\n```\n\n## 使用方法\n\n### 1. 命令行启动\n\n```bash\n# 直接运行（安装后）\navc-test-py-mcp --base-url https://mcp.luluhero.com --api-key your-api-key\n\n# 或使用环境变量\nexport HTTP_API_BASE_URL=https://mcp.luluhero.com\nexport HTTP_API_KEY=your-api-key\navc-test-py-mcp\n```\n\n### 2. 在 Claude Desktop 中配置\n\n编辑 Claude Desktop 配置文件：\n\n**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n\n**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"video-enhancement\": {\n      \"command\": \"avc-test-py-mcp\",\n      \"args\": [\n        \"--base-url\",\n        \"https://mcp.luluhero.com\",\n        \"--api-key\",\n        \"your-api-key\"\n      ]\n    }\n  }\n}\n```\n\n### 3. 使用 uv run 运行（开发模式）\n\n```bash\nuv run avc-test-py-mcp --base-url https://mcp.luluhero.com --api-key your-api-key\n```\n\n## 提供的 Tools\n\n### create_task\n\n创建视频增强任务（异步）。\n\n**参数：**\n- `video_source` (string, required): 视频 URL 或本地文件路径\n- `type` (string, optional): 上传类型，默认 \"url\"\n  - 可选值: `\"url\"` - 网络视频URL, `\"local\"` - 本地文件路径\n- `resolution` (string, optional): 目标分辨率，默认 720p\n  - 可选值: 480p, 540p, 720p, 1080p, 2k\n\n**使用示例：**\n\n```python\n# URL 方式\n{\n  \"video_source\": \"https://example.com/video.mp4\",\n  \"type\": \"url\",\n  \"resolution\": \"1080p\"\n}\n\n# 本地文件方式\n{\n  \"video_source\": \"/path/to/local/video.mp4\",\n  \"type\": \"local\",\n  \"resolution\": \"1080p\"\n}\n```\n\n**返回值：**\n```json\n{\n  \"success\": true,\n  \"task_id\": \"xxx\",\n  \"status\": \"wait\"\n}\n```\n\n### get_task_status\n\n查询任务状态。\n\n**参数：**\n- `task_id` (string, required): 任务ID\n\n**使用示例：**\n```python\n{\n  \"task_id\": \"task-123-abc\"\n}\n```\n\n**返回值：**\n```json\n{\n  \"success\": true,\n  \"task_id\": \"xxx\",\n  \"status\": \"completed\",\n  \"progress\": 100,\n  \"video_url\": \"https://...\",\n  \"error_message\": null,\n  \"created_at\": \"2024-01-01T00:00:00Z\",\n  \"updated_at\": \"2024-01-01T00:01:00Z\"\n}\n```\n\n### enhance_video_sync\n\n同步增强视频（阻塞等待完成）。\n\n**参数：**\n- `video_source` (string, required): 视频 URL 或本地文件路径\n- `type` (string, optional): 上传类型，默认 \"url\"\n  - 可选值: `\"url\"` - 网络视频URL, `\"local\"` - 本地文件路径\n- `resolution` (string, optional): 目标分辨率，默认 720p\n- `poll_interval` (number, optional): 轮询间隔（秒），默认 5\n- `timeout` (number, optional): 超时时间（秒），默认 600\n\n**使用示例：**\n```python\n{\n  \"video_source\": \"https://example.com/video.mp4\",\n  \"type\": \"url\",\n  \"resolution\": \"1080p\",\n  \"poll_interval\": 5,\n  \"timeout\": 600\n}\n```\n\n**返回值：**\n```json\n{\n  \"success\": true,\n  \"task_id\": \"xxx\",\n  \"status\": \"completed\",\n  \"progress\": 100,\n  \"video_url\": \"https://...\"\n}\n```\n\n## 文件上传说明\n\n当 `type` 设置为 `\"local\"` 时，MCP Server 会：\n1. 读取本地文件\n2. 将文件转为 base64 编码\n3. 上传到视频增强服务\n\n**限制：**\n- 最大文件大小：100MB\n\n## 环境变量\n\n| 变量名 | 说明 | 默认值 |\n|--------|------|--------|\n| `HTTP_API_BASE_URL` | FastAPI HTTP Server 地址 | `https://mcp.luluhero.com` |\n| `HTTP_API_KEY` | API 认证密钥 | 无 |\n\n## 开发\n\n```bash\n# 克隆仓库\ngit clone https://github.com/yourusername/avc-test-py-mcp.git\ncd python_client\n\n# 安装开发依赖\nuv pip install -e \".[dev]\"\n\n# 运行测试\npytest\n\n# 代码格式化\nruff format .\nruff check --fix .\n```\n\n## 发布到 PyPI\n\n```bash\n# 安装构建工具\nuv pip install build twine\n\n# 构建分发包\npython -m build\n\n# 上传到 PyPI（测试）\npython -m twine upload --repository testpypi dist/*\n\n# 上传到 PyPI（正式）\npython -m twine upload dist/*\n```\n\n## License\n\nMIT License - 详见 [LICENSE](LICENSE) 文件\n",
  "bytes": 4045,
  "sha": "eff79d4ea53c41f2d5ed025ffc7412c8eec5864b4a5b2f2839ccc1178b43cf83",
  "repo_slug": "z416479660/avc-test-py-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_z416479660_avc_test_py_mcp_aab0e32c/readme"
}