お問い合わせ

Codex、Claude Code、Claude Desktop、およびその他のstdio MCP クライアントが、TikTok LIVE Studio を localhost Stream Deck ソケットで制御できるローカルモデルコンテキストプロトコルサーバーです。 IOチャンネル。

サーバはマウスの自動化、OCR、ブラウザの自動化、または画面の座標を使用しません。 実行中の LIVE Studio プロセスとその所有ポートを発見し、プロトコルを検証し、各アクションを認識し、読みやすい状態の変化を検証します。

コミュニティプロジェクト TikTok、ByteDance、Elgato、Anthropic、またはOpenAIと提携していません。

##特徴

• ステータス、シーン、ソース、オーディオ、マイク、録音、アクション、LIVEコントロール用のMCPツールを12種類搭載。
• stdioの輸送の公式MCP TypeScript SDK。
• Windowsプロセス、インストールバージョン、およびプロセス所有のポート検出。
• ライブスタジオが異なるポートで再起動したときに自動再発見。
• 没入シーン/ソース/オーディオ/マイク/録画/ライブ操作。
• アクションレスト検証とポストアクションの状態検証。
• 複数のローカル構成された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": {