nexus-typo-mcp: MCP server Nexus Typo cho agent AI

Cho agent (Claude Code, Claude Desktop, Cursor, Codex...) thêm tiêu đề chữ theo bộ style đã duyệt, phụ đề và tiếng động (SFX) vào video bất động sản dọc 9:16 đã dựng xong, rồi xuất MP4 ngay trên máy người dùng. Agent đọc hướng dẫn, sửa tên riêng nghe sai, viết kịch bản chữ, xem ảnh duyệt, dựng video, đọc báo cáo tự soát.

Cần: Node 22 trở lên, Google Chrome. ffmpeg, ffprobe không có trên máy thì dùng bản đi kèm gói.

Cài

Claude Code:

claude mcp add nexus-typo -- npx -y nexus-typo-mcp@latest

Windows (Claude Code):

claude mcp add nexus-typo -- cmd /c npx -y nexus-typo-mcp@latest

Claude Desktop, Cursor (macOS, Linux):

{ "mcpServers": { "nexus-typo": { "command": "npx", "args": ["-y", "nexus-typo-mcp@latest"] } } }

Windows:

{ "mcpServers": { "nexus-typo": { "command": "cmd", "args": ["/c", "npx", "-y", "nexus-typo-mcp@latest"] } } }

@latest làm npx lấy bản mới mỗi lần mở lại ứng dụng AI; có bản mới thì server nhắc agent bảo người dùng khởi động lại.

Khoá ElevenLabs (chép lời)

Chép lời dùng ElevenLabs Scribe, khoá của người dùng: biến môi trường ELEVENLABS_API_KEY, hoặc file ~/.nexus-typo/.env có dòng ELEVENLABS_API_KEY=.... Không có khoá: xuất phụ đề SRT từ CapCut (Chữ, Phụ đề tự động, xuất SRT) rồi đưa file đó cho agent (transcript_file).

Khoá chỉ cần hai quyền: Speech to Text (chép lời) và Audio Isolation (tách giọng khi đổi nhạc, music_mode doi). Tạo khoá giới hạn quyền như vậy thì gọi trang tài khoản (thông tin người dùng, gói cước) báo lỗi 401 là bình thường, không phải khoá hỏng: thử khoá bằng prepare_video.

Công cụ

| Công cụ | Việc | |---|---| | get_guide | quy trình trên máy, cách viết kịch bản chữ, bảng style, kịch bản mẫu | | check_setup | kiểm Node, ffmpeg, Chrome, khoá ElevenLabs | | prepare_video | đọc video, ảnh chuyển cảnh, chép lời, sửa lời; trả lời đã chép và ảnh tổng quan | | fix_transcript | sửa tên riêng nghe sai | | validate_script | lưu kịch bản, kiểm luật, chia phụ đề | | previews | ảnh duyệt từng cảnh typo | | render | dựng video (chạy nền), trả đường dẫn MP4 và báo cáo tự soát | | job_status | theo dõi việc đang chạy, lấy kết quả, huỷ |

Việc dài trả job_id; job_status với wait_seconds tới 55 để chờ. File trung gian ở thư mục <tên video>.nexus-typo/ cạnh video, video ra ở ket-qua/ cạnh video. Lần đầu bật chữ sau người, gói tự cài onnxruntime và tải mô hình vào ~/.nexus-typo/ (khoảng 300 MB).

Gửi file đi

Video ra FullHD 1080x1920 (video vào lớn hơn thì tool tự thu). render với share: true ra thêm bản gửi _share.mp4 (bitrate bằng video gốc) cạnh bản chính, làm sau bản chính (mỗi lúc một bộ mã hoá, đỡ RAM); max_mb khai trần dung lượng (có share thì áp vào bản gửi). Tải lên một lần (GitHub Release, kho nhận file qua một kết nối) chỉ hợp file dưới khoảng 500 MB.

Lệnh chạy cho từng file ra: bản chính ngay khi tự soát ĐẠT (trước khi làm bản gửi), bản gửi khi bản gửi xong. Ghi ở ~/.nexus-typo/may.json:

{ "post_export_cmd": ["rclone", "copy", "{share}", "drive:video-ra"] }

Dạng mảng chạy thẳng: lượt bản chính thay {video} và bỏ tham số có {share}, lượt bản gửi thay {share} và bỏ tham số có {video}; lệnh không nhắc file của lượt nào thì bỏ qua lượt đó (ví dụ trên chỉ gửi bản gửi), không nhắc file nào thì chạy một lần sau bản chính. Dạng chuỗi chạy qua shell mỗi lượt, đường file ở biến môi trường NT_FILE (file của lượt), NT_BAN (chinh, gui). Lệnh chỉ đọc từ file này, công cụ MCP không nhận lệnh.

Bước ghép mã hoá từng khúc khoảng 20 s rồi nối lại không mã hoá lại: máy tắt, máy ảo bị thay giữa chừng thì gọi lại render, tool làm tiếp từ khúc dở (khúc xong giữ ở ~/.nexus-typo/cache/xuat/, ghép xong tự dọn).

Máy ảo có bóng RAM báo RAM dùng được thấp giả: bước ghép tự xin thử RAM thật, xin được là ghép luôn. Thiếu thật thì tự chờ, đo lại mỗi 30 s, tối đa 15 phút (--cho-ram <phút> ở CLI), rồi báo RAM đang bị giữ ở đâu.

Biến môi trường

| Biến | Việc | |---|---| | ELEVENLABS_API_KEY | khoá chép lời | | NT_FFMPEG, NT_FFPROBE | file chạy ffmpeg, ffprobe (mặc định: PATH, rồi bản đi kèm gói) | | NT_CHROME | file chạy Chrome khi nằm chỗ lạ | | NT_NHA | thư mục riêng thay ~/.nexus-typo |