Английский язык Titng Việt

Локальный сервер протокола Model Context Protocol для Windows, который позволяет Codex, Claude Code, Claude Desktop и другим клиентам stdio MCP управлять TikTok LIVE Studio через локальный хост Stream Deck Socket. Канал ИО.

Сервер не использует автоматизацию мыши, OCR, автоматизацию браузера или координаты экрана. Он обнаруживает запущенный процесс LIVE Studio и принадлежащий ему порт, проверяет протокол, подтверждает каждое действие и проверяет читаемые изменения состояния.

Общественный проект. Не связан с TikTok, ByteDance, Elgato, Anthropic или OpenAI.

Особенности

Двенадцать типизированных инструментов MCP для статуса, сцен, источников, аудио, микрофона, записи, действий и управления LIVE.

• Официальный MCP TypeScript SDK со стиотранспортом. Процесс Windows, встроенная версия и обнаружение портов, принадлежащих процессу. Автоматическое повторное открытие, когда LIVE Studio перезапускается на другом порту.
• Идемпотентная сцена/источник/аудио/микрофон/запись/живые операции.
• Проверка результатов действия плюс проверка состояния после действия. Кросс-процесс блокировки мутации для нескольких локально настроенных MCP-клиентов. Структурированный контракт на ошибку и компактные журналы доказательств JSONL.
• Мок Сокет.

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": {