한국어 | Tiếng Việt

Codex, Claude Code, Claude Desktop 및 다른 stdio MCP 클라이언트가 로컬 호스트 스트림 데크 소켓을 통해 TikTok LIVE Studio를 제어하는 Windows용 로컬 모델 콘텍스 프로토콜 서버. IO 채널.

서버는 마우스 자동화, OCR, 브라우저 자동화, 화면 좌표를 사용하지 않습니다. LIVE Studio 프로세스와 소유 포트를 발견하고 프로토콜을 검증하고 각 작업을 인정하고 읽기 가능한 상태 변경을 검증합니다.

커뮤니티 프로젝트. TikTok, ByteDance, Elgato, Anthropic 또는 OpenAI와 제휴하지 않습니다.

특징

• 상태, 장면, 소스, 오디오, 마이크, 녹음, 행동 및 LIVE 컨트롤을 위한 MCP 툴을 입력했습니다.
• 공식 MCP TypeScript SDK 와 stdio 수송.
• Windows 프로세스, 설치 버전 및 프로세스 소유 포트 발견.
• LIVE Studio가 다른 포트에서 다시 시작합니다.
• Idempotent 장면/source/audio/microphone/recording/LIVE 가동.
• Action-result validation plus post-action state 검증.
• 여러 로컬로 구성된 MCP 클라이언트를 위한 Cross-process mutation 자물쇠.
• 구조 오류 계약 및 컴팩트 JSONL 증거 로그.
• Mock 소켓.

TikTok LIVE Studio MCP

English | Tiếng Việt

A local Model Context Protocol server for Windows that lets Codex, Claude Code, Claude Desktop, and other stdio MCP clients control TikTok LIVE Studio through its localhost Stream Deck Socket.IO channel.

The server does not use mouse automation, OCR, browser automation, or screen coordinates. It discovers the running LIVE Studio process and its owned port, validates the protocol, acknowledges each action, and verifies readable state changes.

Community project. Not affiliated with TikTok, ByteDance, Elgato, Anthropic, or OpenAI.

Features

• Twelve typed MCP tools for status, scenes, sources, audio, microphone, recording, actions, and LIVE control.
• Official MCP TypeScript SDK with stdio transport.
• Windows process, installed-version, and process-owned port discovery.
• Automatic rediscovery when LIVE Studio restarts on a different port.
• Idempotent scene/source/audio/microphone/recording/LIVE operations.
• Action-result validation plus post-action state verification.
• Cross-process mutation lock for multiple locally configured MCP clients.
• Structured error contract and compact JSONL evidence logs.
• Mock Socket.IO, MCP contract, real safe integration, opt-in full integration, built stdio, packaging, and release gates.

Requirements

• Windows 10 or Windows 11.
• Node.js 20 or newer.
• TikTok LIVE Studio installed. Start it before running doctor or real integration checks.

Quick start

git clone https://github.com/dannguyen9x/tiktok-live-studio-mcp.git
cd tiktok-live-studio-mcp
npm.cmd ci
npm.cmd run build
npm.cmd run doctor
npm.cmd run mcp:smoke

Then connect your MCP client using the client setup guide. For a complete walkthrough, safety model, examples, updates, and uninstall steps, read the full user guide or Vietnamese user guide.

Run the server directly:

npm.cmd start

MCP uses stdout, so ordinary runtime logs are written to artifacts/evidence/runtime.jsonl rather than stdout.

MCP client configuration

Copy the relevant example and replace C:/path/to/tiktok-live-studio-mcp with the absolute clone path:

• .mcp.json.example
• config/claude-desktop.example.json
• config/claude-code.example.json
• config/codex.example.toml

The common stdio configuration is:

{
  "mcpServers": {
    "tiktok-live-studio": {
      "command": "node",
      "args": [
        "C:/path/to/tiktok-live-studio-mcp/dist/src/index.js"
      ],
      "env": {