avc-test-js-mcp (Node.js)

Сервис улучшения видео на основе протокола MCP, взаимодействующий с FastAPI HTTP-сервером в качестве MCP Client-Server.

Функции

Предоставляет следующие инструменты MCP:

• create_task - создание задачи по улучшению видео (поддерживает URL или загрузку локальных файлов)

• get_task_status - запрос статуса задачи

• enhance_video_sync - синхронное улучшение видео (блокирующее ожидание)

Установка

Установка из npm (рекомендуется)

npm install -g avc-test-js-mcp

Или используйте yarn/pnpm:

yarn global add avc-test-js-mcp
pnpm add -g avc-test-js-mcp

Установка из исходного кода

git clone https://github.com/yourusername/avc-test-js-mcp.git
cd js_client
npm install
npm run build

Использование

1. Запуск из командной строки

Используйте напрямую после глобальной установки:

avc-test-js-mcp --base-url https://mcp.luluhero.com --api-key your-api-key

Или используйте переменные окружения:

# Windows PowerShell
$env:HTTP_API_BASE_URL="https://mcp.luluhero.com"
$env:HTTP_API_KEY="your-api-key"
avc-test-js-mcp

# Windows CMD
set HTTP_API_BASE_URL=https://mcp.luluhero.com
set HTTP_API_KEY=your-api-key
avc-test-js-mcp

# macOS/Linux
export HTTP_API_BASE_URL=https://mcp.luluhero.com
export HTTP_API_KEY=your-api-key
avc-test-js-mcp

2. Настройка в Claude Desktop

Отредактируйте файл конфигурации Claude Desktop:

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

Windows: %APPDATA%/Claude/claude_desktop_config.json

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

3. Использование npx (без глобальной установки)

npx avc-test-js-mcp --base-url https://mcp.luluhero.com --api-key your-api-key

Конфигурация Claude Desktop:

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

Предоставляемые инструменты

create_task

Создание задачи по улучшению видео (асинхронно).

Параметры:

• video_source (string, обязательный): URL видео или путь к локальному файлу

• type (string, опциональный): тип загрузки, по умолчанию "url"

  • Допустимые значения: "url" - URL видео из сети, "local" - путь к локальному файлу

• resolution (string, опциональный): целевое разрешение, по умолчанию 720p

  • Допустимые значения: 480p, 540p, 720p, 1080p, 2k

Пример использования:

// URL 方式
{
  "video_source": "https://example.com/video.mp4",
  "type": "url",
  "resolution": "1080p"
}

// 本地文件方式
{
  "video_source": "/path/to/local/video.mp4",
  "type": "local",
  "resolution": "1080p"
}

Возвращаемое значение:

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

get_task_status

Запрос статуса задачи.

Параметры:

• task_id (string, обязательный): ID задачи

Пример использования:

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

Возвращаемое значение:

{
  "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, обязательный): URL видео или путь к локальному файлу

• type (string, опциональный): тип загрузки, по умолчанию "url"

  • Допустимые значения: "url" - URL видео из сети, "local" - путь к локальному файлу

• resolution (string, опциональный): целевое разрешение, по умолчанию 720p

• poll_interval (number, опциональный): интервал опроса (в секундах), по умолчанию 5

• timeout (number, опциональный): время ожидания (в секундах), по умолчанию 600

Пример использования:

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

Возвращаемое значение:

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

Примечания по загрузке файлов

Когда type установлен в "local", MCP-сервер выполняет следующие действия:

1. Читает локальный файл

2. Преобразует файл в кодировку base64

3. Загружает его на сервис улучшения видео

Ограничения:

• Максимальный размер файла: 100 МБ

Переменные окружения

Разработка

# 克隆仓库
git clone https://github.com/yourusername/avc-test-js-mcp.git
cd js_client

# 安装依赖
npm install

# 开发模式（自动编译）
npm run dev

# 构建
npm run build

Лицензия

Лицензия MIT - подробнее см. в файле LICENSE