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

npm version Node.js >=18 License: MIT

MCP 프로토콜 기반의 비디오 향상 서비스로, MCP Client-Server와 FastAPI HTTP 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, required): 비디오 URL 또는 로컬 파일 경로
type (string, optional): 업로드 유형, 기본값 "url"
- 선택 가능 값: "url" - 웹 비디오 URL, "local" - 로컬 파일 경로
resolution (string, optional): 대상 해상도, 기본값 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, required): 작업 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, required): 비디오 URL 또는 로컬 파일 경로
type (string, optional): 업로드 유형, 기본값 "url"
- 선택 가능 값: "url" - 웹 비디오 URL, "local" - 로컬 파일 경로
resolution (string, optional): 대상 해상도, 기본값 720p
poll_interval (number, optional): 폴링 간격(초), 기본값 5
timeout (number, optional): 타임아웃 시간(초), 기본값 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 서버는 다음을 수행합니다:

로컬 파일 읽기
파일을 base64로 인코딩
비디오 향상 서비스로 업로드

제한 사항:

최대 파일 크기: 100MB

환경 변수

변수명	설명	기본값
`HTTP_API_BASE_URL`	FastAPI HTTP Server 주소	`https://mcp.luluhero.com`
`HTTP_API_KEY`	API 인증 키	없음

개발

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

# 安装依赖
npm install

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

# 构建
npm run build

라이선스

MIT 라이선스 - 자세한 내용은 LICENSE 파일을 참조하세요.

Video Enhancement MCP Server

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

기능

설치

npm에서 설치 (권장)

소스 코드에서 설치

사용 방법

1. 명령줄 실행

2. Claude Desktop 설정

3. npx 사용 (전역 설치 불필요)

제공되는 도구

create_task

get_task_status

enhance_video_sync

파일 업로드 설명

환경 변수

개발

라이선스

Resources

Looking for Admin?

Tools

Latest Blog Posts

MCP directory API