英文 |越南

这是一个面向 Windows 的本地模型上下文协议服务器，允许 Codex、Claude Code、Claude Desktop 及其他标准 MCP 客户端通过其本地主机 Stream Deck Socket.IO 频道控制 TikTok LIVE Studio。

服务器不使用鼠标自动化、OCR、浏览器自动化或屏幕坐标。它会发现正在运行的LIVE Studio进程及其自有端口，验证协议，确认每个操作，并验证可读状态变化。

社区项目。与TikTok、字节跳动、Elgato、Anthropic或OpenAI无关。

特色

• 十二种类型化的MCP工具，用于状态、场景、源、音频、麦克风、录音、动作和实时控制。
• 官方MCP TypeScript SDK 支持stdio传输。
• 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": {