プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

像塑 MCP Plus

作者:Muqian-Sunバージョン 0.9.0i★ 2iパソコンで動くリポジトリ ↗
レジストリ名io.github.Muqian-Sun/xiangsu-mcp-plus

インストール方法

What it does

Unofficial macOS MCP for Douyin AR (像塑): assets, menus, AI combine, delivery. For learning only.

  • Connects パソコンで動く
  • Account or key No key needed
  • Category ゲーム・スポーツ・料理・学習

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気6/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア18/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

像塑 MCP Plus をインストールして。https://mcp.popnx.com/i/muqian-sun-xiangsu-mcp-plus.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月13日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

AI にインストールしてもらう

このメッセージを Claude のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude に MCP server 像塑 MCP Plus を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "xiangsu-plus": { "command": "npx", "args": [ "-y", "@muqian/xiangsu-mcp-plus" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、像塑 MCP Plus のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  3. この設定を貼り付けて保存

    {
      "mcpServers": {
        "xiangsu-plus": {
          "command": "npx",
          "args": [
            "-y",
            "@muqian/xiangsu-mcp-plus"
          ]
        }
      }
    }
  4. Claude を終了してもう一度開く

  5. 試してみる

    像塑 MCP Plus を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が 像塑 MCP Plus を使っていると言うか、回答に 像塑 MCP Plus のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ 像塑 MCP Plus につなげません

像塑 MCP Plus はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · 像塑 MCP Plus につなげるアプリを使う

  • 先にパソコンへ Node.js を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)
  • 先にパソコンへ Node.js を入れてください(1 回だけ)

B · ゲーム・スポーツ・料理・学習 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Claude Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Claude Code に MCP server 像塑 MCP Plus を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):claude mcp add --scope user xiangsu-plus -- npx -y @muqian/xiangsu-mcp-plus 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、像塑 MCP Plus のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --scope user xiangsu-plus -- npx -y @muqian/xiangsu-mcp-plus
  4. Claude Code で /mcp と入力

    像塑 MCP Plus が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    像塑 MCP Plus を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が 像塑 MCP Plus を使っていると言うか、回答に 像塑 MCP Plus のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを Cursor のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの Cursor に MCP server 像塑 MCP Plus を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "mcpServers": { "xiangsu-plus": { "command": "npx", "args": [ "-y", "@muqian/xiangsu-mcp-plus" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、像塑 MCP Plus のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. Cursor の AI チャットを Agent モードで開く

  4. 試してみる

    像塑 MCP Plus を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が 像塑 MCP Plus を使っていると言うか、回答に 像塑 MCP Plus のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

先にパソコンへ Node.js を入れてください(1 回だけ)

AI にインストールしてもらう

このメッセージを VS Code のチャットに貼り付けます。AI がパソコンを確認し、変更するファイルを伝え、毎回あなたの了承を待ちます。

このパソコンの VS Code に MCP server 像塑 MCP Plus を入れてください。順番に:1) node -v で Node.js があるか確認。なければ https://nodejs.org/en/download から入れるよう私に伝え、自分では入れない。2) この設定だけを使う(PopNx MCP の確認済み):{ "servers": { "xiangsu-plus": { "type": "stdio", "command": "npx", "args": [ "-y", "@muqian/xiangsu-mcp-plus" ] } } } 3) 変更するファイルのフルパスか実行するコマンドを伝えて、私の了承を待つ。4) キーは不要。5) 了承した内容を実行し、像塑 MCP Plus のツールが本当に表示されるか確認する。

このメッセージにあなたのキーは含まれません。キーが必要な場合は、AI がファイルやアプリの入力欄にご自身で貼るよう案内します。

  1. Node.js を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    node -v
    • バージョン番号(例 v26.13.1)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: 公式ダウンロードページで LTS 版と、クリックで進むインストーラーを選びます:Mac は .pkg、Windows は .msi。ダブルクリックして最後まで進めるだけで、curl コマンドは不要です

    Node.js のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: node -v

    一度入れれば、Node.js を使うすべてのツールで使えます

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. VS Code の AI チャットを Agent モードで開く

  4. 試してみる

    像塑 MCP Plus を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が 像塑 MCP Plus を使っていると言うか、回答に 像塑 MCP Plus のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?像塑 MCP Plus を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user xiangsu-plus -- npx -y @muqian/xiangsu-mcp-plus

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "xiangsu-plus": {
      "command": "npx",
      "args": [
        "-y",
        "@muqian/xiangsu-mcp-plus"
      ]
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "xiangsu-plus": {
      "command": "npx",
      "args": [
        "-y",
        "@muqian/xiangsu-mcp-plus"
      ]
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "xiangsu-plus": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@muqian/xiangsu-mcp-plus"
      ]
    }
  }
}

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
npm/PyPIにない
接続方法
パソコンで動く
最新バージョンi
0.9.0
レジストリ公開日i
2026年11月11日
コードの最終更新i
2026年11月19日
作者
Muqian-Sun
パッケージ
npm: @muqian/xiangsu-mcp-plus
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント Muqian-Sun で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:今日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に @muqian/xiangsu-mcp-plus@0.9.0 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/muqian-sun-xiangsu-mcp-plus.svg)](https://mcp.popnx.com/en/servers/muqian-sun-xiangsu-mcp-plus)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

ゲーム・スポーツ・料理・学習のほかのサーバーとの比較i

  • このカテゴリのほかの1619件のうち91%よりスターが多い
  • このカテゴリのほかの1619件のうち77%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの1619件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

像塑 MCP Plusは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は今日、最新バージョン(0.9.0)がレジストリに届いたのは8 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは?

同じカテゴリには:Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft, GoodWatch

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

WilmAI

Finland's Wilma school system for parents and students: schedule, homework, exams and messages.

作者:aikarjal成長中↓ 1399/週★ 89 リポジトリ全体のスター10 日前更新

パソコンで動く✓ 提供元 · wilm.ai

Savecraft

Savecraft serves real save game data and expert game knowledge to AI assistants.

作者:joshsymonds初期★ 137 か月前更新

クラウドで動くリポジトリはアーカイブ済み✓ 提供元 · savecraft.gg

GoodWatch

Find movies and TV shows, track watches, and get suggestions based on your taste.

作者:alp82初期★ 50 リポジトリ全体のスター30 日前更新

クラウドで動く✓ 提供元 · goodwatch.app
似たものと比べる
これ
像塑 MCP Plus
Anime GardenWilmAILumify Sports IntelligenceSavecraftGoodWatch
動く場所パソコンにインストールが必要クラウドで動き、インストール不要パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要いいえいいえいいえはいいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック3/34/43/34/43/44/4
ライセンスMITAGPL-3.0MITMITApache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

xiangsu-mcp-plus

像塑(Douyin AR,macOS)的 MCP 扩展:一个 MCP 服务同时提供像塑官方 MCP 的全部工具,以及官方 MCP 够不到的编辑器能力。

  • 官方工具原样转发(get_scene、edit_by_dsl、capture_preview、save_project 等),像塑重启后自动重连,官方工具列表变化时通知客户端刷新。官方 MCP 每次调用只回一个完整的 JSON,请求发出后连接断了的调用可能还在编辑器里跑(生成类会扣额度),所以不自动重发,报 OFFICIAL_MCP_DISCONNECTED;连不上编辑器(什么都没执行)报 OFFICIAL_MCP_UNAVAILABLE。插件和官方调用都不受 Node 自带 fetch 的 300 秒响应头超时限制,等多久只看各工具自己的超时。唯一的例外是 capture_preview:9.8.1 起官方截图是给窗口里的预览区域拍照,窗口最小化或不可见时是黑的,这时改为重置预览、等到重载后的画面,从预览的渲染结果截取并缩小到官方的 320×569(不含界面元素);窗口可见时照旧转发,这时刚改完场景或换了预览视频可能还是旧画面(工具说明里写了这一点),要确认新画面用 preview_frames。
  • 官方素材库:浏览、搜索、看封面、应用(脸部变形、美型、AI 实时变脸、美妆、滤镜、贴纸、画面特效等),流程与素材库面板相同;包括「素材广场」(其他创作者分享的现成 AI 图片、AI 妆容、自定义实时变脸、贴纸和素材包,应用时不重新生成、不扣额度)和自己的「收藏」。
  • 「添加对象」菜单:工具栏美妆 / 美型 / AI 实时变脸里的全部官方功能项(美容、面部生成、表情生成、性别年龄、五官处理、身体换装等),可看示意图后按菜单项 ID 添加。
  • AI 组合效果(用户拍照后在云端按工作流出图或出视频):像 AI 效果窗口的「新建工作流」一样建工作流,交给官方工作流工具编辑,再像「应用」一样放进场景。
  • 素材库「AI 妆容」:从一张带妆的参考图提取面部、美瞳、眼部、睫毛、唇部五张妆容贴图和推荐强度,看样例脸上的整妆预览,再按部位导入成「面部面具」下的妆容层;提交、记录和建层都驱动面板自己的 AIMakeupManager,并补上面板没写进美瞳层的 AI 美瞳贴图和强度。
  • 素材库「AI 3D」:图生 3D 模型(一张图 → 静态 GLB 网格)、3D 动画(视频里人的动作 → 套到带标准人形骨骼的 FBX 上)、高精度模型重建(实物环绕视频 → 3D 高斯点云),提交、等待、取消任务,把结果导入工程,请求和导入方式与面板相同。
  • 素材库「AR 视频」(AR 视频贴片):一张主体图或一段主体视频,按动作描述和参考素材生成新动作(或直接抠像),抠好的视频作为 AR 平面贴片放进场景;提交、看抽帧预览、导入、取消都驱动面板自己的 ARVideoManager。
  • 首页作品:浏览、搜索、看封面,下载完整工程到本地或直接在编辑器里打开(官方工程和已发布的作品),供 agent 读取场景、脚本和资源,学习别人的做法;下载的东西都有登记,用完即删,最长保留 24 小时。
  • 交付:设置并上传图标、特效检测(和编辑器里点「特效检测」一样,云端检测)、填好提交窗口(名称、触发提示、摄像头方向、灵感、任务,一直走到「提交审核」页并等检测跑完),确认后勾协议、点「提交审核」送审并读回特效 ID、手机预览二维码、把已领取的任务或创作灵感绑定到工程。
  • 抖音音乐:按分类或关键词找歌,设为特效音乐。
  • 灵感、任务、排行榜:首页「灵感」页签和活动中心的任务(征集任务、成长任务),以及像塑移动版才有的排行榜(年轻 / 男生 / 女生喜爱榜、每日投稿榜、热玩互动榜、跟拍榜,各榜按两级分类细分;热点榜;专题合集里两百多期主题特效榜和模板榜;创新计划官方精选),用编辑器里登录的账号读取;可收藏灵感、领取任务。
  • 看别人的特效、学做法:像塑移动版的全平台搜索(特效、模板、灵感、教程),任意特效的详情(等级、受众、平台判定的类型、用到的编辑器能力、作者)和用它拍的热门视频,排行榜上没分享工程的特效找「做同款」指向的首页工程;官方教程和官方拍摄脚本。
  • 运营数据:自己作品的审核状态和驳回原因、精选进度(进没进精选审核、首轮 / 二审 / 结果、按我们历史估的出结果时间)、作品数据和按天趋势、收益、账号和等级、站内信、拍视频激励、从上次告诉用户以来的变化,以及给选方向用的开工简报(从爆款倒推的为什么想玩、AI 写的主攻赛道建议、赛道表、入选样例、失败经验、热点的涨落和扎堆、新灵感和新任务、任务占用)和查题材扎不扎堆,都从运营平台(xiangsu.muqian.chat,作品和站内信每 10 分钟、市场数据每天取一次)的只读接口读:pipeline_*、account_status、changes_*、brief_today、track_board、pick_samples、failure_lessons、hot_topics、task_usage。原来直接从编辑器读账号数据的 13 个工具 2026-11-13 下架,旧版看板的 ops_* 2026-11-14 下架;插件里对应的取数函数还在,运营平台部署时复用它们。
  • 塑型画笔(FaceWarpX)强度:官方能读不能写,这里按检查器滑块的方式改。
  • 工程窗口:新建空白工程(首次保存到指定目录)、打开、关闭。本服务开的窗口一律最小化在程序坞里、不抢前台(见下文约定)。
  • 干净删除:删除对象时找出只被它使用的资源和它导入时带进来的素材包文件夹,确认后删除。
  • 做素材(不用开像塑,原来每个工程各写一遍的脚本):从预览帧裁图标并压字幕、出列表大小的对比图;按预设合成音效(照各工程音效脚本移植)出 MP3;描边 / 渐变 / 投影文字和圆角、胶囊底板 PNG;把自己的模特照片(或两张照片交替)转成预览视频加进像塑的预览清单;改场景文件里对象的渲染图层和摄像机可见层(DSL 改不了)。文字和图片用 Skia(@napi-rs/canvas)渲染,默认用像塑自带的抖音体,音视频用像塑自带的 ffmpeg。
  • 9.8.3 素材库「AI 生成」里新增的面板:「画面特效」(描述加参考图 / 视频生成全屏画面特效并导入)和「实时变脸」(一张参考图训练自己的 AI 实时变脸:预览、训练、导入),都驱动面板自己的管理器。
  • 图片编辑器的 AI 工具:超清、消除、按描述局部重绘、AI 抠图(主体和头发、身体等部位),不打开窗口。
  • 预览输入(官方 interact_by_dsl 不收的,走编辑器内置 Agent 的命令):给预览喂模拟的音量、音高、关键词命中,验声音玩法;预览视频跳到指定时刻、按住拖动、切到某个手势的预览视频。

非官方项目,与字节跳动 / 抖音无关。依赖像塑编辑器的内部模块(9.7.2 起实测,当前在 9.8.3 上自检全部通过),像塑升级后可能失效;ext_status 会逐项自检并列出缺失的接口。仓库不包含任何像塑的程序、代码或素材。

只用于学习和个人制作,禁止用来抄袭他人作品(详见协议与声明)。npm 包名 @muqian/xiangsu-mcp-plus。

工作方式

部分位置作用
编辑器插件 XiangsuMcpExteditor-plugin/像塑用户插件。每个工程窗口里开一个只监听 127.0.0.1、带随机令牌的 RPC 服务,调用编辑器自身的模块
MCP 服务src/server.mjsstdio MCP。转发官方 MCP(http://127.0.0.1:17320/mcp),并把插件能力包装成工具

插件把 {pid, port, token, startedAt} 写到 ~/.xiangsu-mcp-ext/instances/ .json(权限 600)。窗口崩溃或被强退时这份记录会留下来,所以只有该 pid 的进程还在、并且启动时间不晚于 startedAt 时才算开着的窗口;pid 被后来的进程复用时不算。插件日志在 ~/.xiangsu-mcp-ext/logs/plugin.log;MCP 服务每次工具调用(名称、耗时、报错、是否发了进度)和异常退出记在 ~/.xiangsu-mcp-ext/logs/server.log,超过 5 MB 时旧的移到 server.log.1;导入记录在 ~/.xiangsu-mcp-ext/imports/。

按工程找窗口时,同时询问各窗口开着哪个工程,卡住或正在关闭的窗口(5 秒没回应)不影响找到其它窗口,并记住每个工程上次所在的窗口,下次先问它。客户端请求带进度令牌时,工具调用期间每 5 秒发一次进度,避免长调用(连续截帧、等提交页检测)被当成空闲掐断。

工具

官方 MCP 的工具按原名提供。扩展工具都接受 project_path 或官方的 instance_id 指定工程(只开一个工程窗口时可省略):

工具作用
ext_status官方 MCP 连接状态;每个工程窗口的 pid、工程路径、instance_id、有没有未保存的改动、编辑器接口自检
project_open / project_new / project_close打开已有工程、新建空白工程并保存到指定目录(窗口都最小化在程序坞里,前台留在原来的应用)、关闭工程窗口(不把首页带出来;有未保存改动时默认拒绝)
image_view看图:列表类工具返回的引用(cover_ref、gif_ref、任务内容块的 image_refs 等,形如 img:12)、详情类工具返回的地址(灵感 images、菜单示意图)或本机图片路径都放进它的 images 数组;视频和音频引用(video:3、audio:5)返回原地址;一次最多 8 张,动图等大图一次给不完时把没给的列在 not_returned 里(单次响应不超过 MCP stdio 的 10 MiB 上限)
library_list / library_search官方素材库面板清单(不传 panel_key,含素材广场、收藏)和面板里的分页列表、关键词搜索:逐个面板查标题以拿全结果;词正好是面板名或子分类名时也带出那里的素材(「滤镜」「腮红」「复古滤镜」),按标题匹配程度排序,queries 一次搜多个词,返回各面板条数和展开了哪些分类,结果缓存 10 分钟供翻页;每条素材带 kind、封面 cover_ref 和命中方式 matched;第一页还附带「添加对象」菜单里同名的项到 menu_items(如「脸蛋天才」,用 menu_add 加)
library_images一张 AI 图片卡片的整组结果图地址(按 image_index 编号)
library_apply下载素材包、校验 MD5、导入并放进场景(可撤销);素材广场卡片按 kind 走编辑器自己的应用流程(AI 图片可用 image_index 选第几张);返回新增对象(素材连带建出渲染组时,组下面这次新加的对象列在 contents)和素材包文件夹;素材广场卡片不给 file_size(恒为 3409,没有意义)
works_list / works_search首页作品分页列表(每页带上全部分类:推荐、官方工程、新手必做、游戏、妆容、AI玩法…;可按推荐 / 最新 / 使用量排序,next_cursor 原样传回翻页)、按作品名搜索(默认搜全部分类并合并去重,每条带 found_in;queries 一次搜多个词;按 offset 分页,结果缓存 10 分钟)
works_by_effect按特效 ID 查排行榜等处的特效在首页有没有工程(一次最多 20 个),逐个返回 found / same_style(移动版「做同款」指向的首页工程,常是别人的另一个特效,same_style 给出是哪个)/ same_name / not_on_homepage
works_download下载并解压完整工程(与首页点开作品同一流程,但不开窗口),返回工程目录和文件概况(key_files 只列工程文件、场景和脚本,其余贴图模型只给计数);dest 给定时把工程放到该目录;同一窗口的下载自动排队
works_open下载并在新窗口里按首页的方式打开(不弹版本升级提示,工程处于未保存状态),返回 pid 和 instance_id
works_cleanup删除下载过的作品(含 dest);编辑器窗口开着的保留,其它路径一律拒绝
icon_set / icon_open把一张图片裁成 360×360 PNG 设为工程图标(默认女性、男性两版,提交窗口要这两个),并像「图标制作」窗口的「完成」一样上传到特效平台(提交窗口只认上传过的图标);或打开「图标制作」窗口(最小化在程序坞里,由用户点开)
icon_compose从预览帧裁正方形图标({top} 或 {x, y, size},帧自己的像素),可压一行描边 / 渐变 / 投影字幕(太宽时等比缩小),出 720(可设)和 160 两张 PNG,一次最多 4 张;另出列表大小的并排图,后面可接同类作品的图标对比。不用开像塑,满意后交给 icon_set
effect_check和工具栏「特效检测」按钮一样:打开特效检测窗口(最小化,不上屏)做云端检测(会上传特效包做测试,不是发布),等待结果,并读出检测页的详情一起返回(页面结论、每项结论、包体积和安卓 / iOS 帧率对上限、没通过的项的改进建议),然后关掉窗口;详情读不出时窗口留着并返回 details_error;超时时窗口留着,下次调用先关掉它
submit_prepare本地检查包体上限、是否原样套用模板、登录、图标,通过后先关掉还开着的提交窗口(之前调用留下的),再走「提交特效」按钮的入口打开一个新的(最小化在程序坞里),逐页填写:名称(必填)、触发提示、默认摄像头方向、灵感、任务和赛道(可用 icon_image 先设图标),翻到「提交审核」页并等页面检测跑完,返回摘要、检测结果、协议是否已同意和 next(你还要做什么)。每一项都从页面读回核对,页面截断、报错、没选上或翻页被拦时报 SUBMIT_* 错误,窗口保持打开。不勾协议,也不点「提交审核」,不会送审
submit_confirm送审:在 submit_prepare 留下的那个提交窗口里勾上《创作者协议》(账号已同意过时不用勾),点「提交审核」,特效真正提交审核、占用提交次数。name 须和窗口摘要一致;页面检测没跑完或没通过时不点;账号最新的 10 个作品里已有同名、在审核中或审核过了的也不点(SUBMIT_ALREADY_SUBMITTED),防止重复提交。点了之后等页面报结果(最多 5 分钟):成功返回 effect_id、是否替你勾了协议、是否提示实名认证,关掉窗口,并到账号最新的作品列表里找到这条特效放在 listed。页面没确认成功(报失败、停止提交却没给结果、没等到结果)时先到作品列表里找这条,找到就照成功返回、页面当时的情况放在 page_problem;找不到才报 SUBMIT_FAILED(页面给了失败原因)或 SUBMIT_RESULT_UNKNOWN,不自动重试,重交前先 pipeline_refresh 再看 pipeline_works
submit_close关掉开着的提交窗口,不打开新的
mobile_preview按手机预览方式打包上传到抖音预览服务,返回和编辑器一样的二维码(7 天有效),抖音 App 扫码真机看;二维码同时存成文件(~/.xiangsu-mcp-ext/mobile-qr/),到期自动删除
inspiration_list / inspiration_detail灵感分页列表(每页带上全部分类,每条带关联热点)、详情(说明、图片、奖励、关联热点的热度和标签、同灵感特效、示例视频的播放地址和封面、贴纸、是否已收藏);关联工程服务端只给标题,没有 id,要下载就拿标题去 works_search
inspiration_collect收藏或取消收藏灵感(写账号),之后重新查询确认生效
inspiration_collected当前账号收藏的灵感(按收藏时间从新到旧分页),字段同 inspiration_list,另有收藏时间、作品类型和所属征集任务;submit_prepare 的 inspiration 就在这些收藏里选
inspiration_bind把灵感绑定到当前工程,提交时带上;提交窗口只列已收藏的灵感,没收藏的会顺手收藏
tasks_list / task_detail活动中心的活动和特效征集任务的列表(按 offset / count 分页)与征集任务详情(状态和状态说明、奖励、整理过的任务说明:每个内容块的条目、参考图和视频引用、奖项金额和名额、链接,save_to 另存原始返回;征集任务详情还有自己提交到这个任务的特效 my_effects:审核状态、拍摄 / 播放 / 投稿峰值、获奖金额、任务评定 task_state(pending / unfinished / done)和是否被标「主题不符合」off_theme)
growth_tasks_list / growth_task_detail活动中心的成长任务列表(奖励、参考工程,分页)与详情(参考工程、相关灵感、教程)
task_receive领取一个待领取(WAIT_RECEIVE)的征集任务(写账号,不能撤销),其它状态直接拒绝;领完自动重读任务列表,接着就能 task_bind
task_bind已领取的任务按任务详情页「去创作」的方式重开工程绑定;这个工程是唯一的窗口时,先开一个不保存的空工程当跳板,绑完关掉
rank_list分页读移动版排行榜(榜单和筛选项写在参数说明里),可按日期、每级一个分类、特效等级、面板、偏好、来自工具、年轻喜爱度过滤;每页带上该榜当天的两级分类(大类如人像美化、细类如美妆)
rank_hotspots热点榜(按 offset / count 分页)
hotspot_inspirations一个热点下的灵感,按热点页页签的顺序分页,每条标出页签
hotspot_inspiration_images把一个热点下全部灵感详情里的图片下载到临时目录(24 小时后删除),文件名带序号和灵感标题,另写 index.json 记下每张图属于哪条灵感;6 条并发,单张 30 秒超时、失败重试一次,失败的灵感列在 failed
rank_subjects专题合集里按主题的特效榜(kind=effect,如「热爆美妆特效榜」「熊出没IP特效榜」)和模板榜(kind=template,如「歌词玩法模板榜」),按 cursor 分页
rank_subjects_search按榜名在专题合集全部期里搜索
rank_subject_detail一个专题榜的全部特效
rank_innovation创新计划官方精选(kind=template / effect);同页重复的特效合成一条、标签合并,服务端翻页会出现上一页的特效
pipeline_works运营平台(xiangsu.muqian.chat):全部作品走到精选的哪一步,分上线、精选、精选奖三条线和要处理 / 等结果 / 已结束三组,驳回和落选原因原文,按我们历史估的出结果时间,任务和灵感评定,曝光 / 投稿 / 收益;账号限制、提交节奏、各块数据的健康
pipeline_work运营平台:一个作品的时间线、按天趋势、数据卡片、能力、流量标签、审核记录、收益、用户视频和全部变化
brief_today运营平台:开工简报,会话开始读一次——账号能不能交、新变化、从爆款倒推的为什么想玩和 AI 按选题流程写的今天主攻方向(倒推自哪几个爆款、借哪个热点、候选绑定和要对上的要求,推断)、赛道表、从我们结果算出的规律、失败经验、热点、新灵感和新任务、任务占用
hit_reasons运营平台:年轻喜爱、每日投稿、热玩互动、跟拍榜前 20 和最近入选的精选,每个带用户视频标题、点赞、封面和 AI 归纳的为什么想玩(推断)
track_board运营平台:全部赛道(细分类型)平台近 30 天 / 7 天精选数,我们做了几个、进审、入选、落选、进审率,最近入选的样例和用到的能力
pick_samples运营平台:官方精选作品明细,按赛道、类型、最近几天筛
failure_lessons运营平台:全部失败经验(驳回、测试未通过、精选落选、首轮没过、没进审),每条带平台原话、次数、涉及作品
hot_topics运营平台:像塑热点,和一天前比的涨落、站内同题材几个、扎堆还是还早,和每个热点下的灵感(只有像塑自己的热点,不含站外热榜)
inspirations_find运营平台:按题材词在全部挂着的灵感里找(【创新】、热点下的、普通的),带玩法说明、激励截止和要同时绑的任务
inspirations_new运营平台:新出现的灵感和现在挂着的【创新】灵感,带玩法说明、激励截止和要同时绑的任务、奖励和前 3 张参考图
tasks_open运营平台:活动中心没截止的全部任务,发布、截止、领没领、同类型条款、要对上的要求原文、我们放了哪些作品
task_requirements运营平台:一个任务的全部说明原文(任务说明、参与要求、奖项详情、灵感玩法),不用开编辑器
topic_crowd运营平台:查一个题材词在站内有几个同题材的特效和模板(平台去搜,工具最多等 60 秒)
task_usage运营平台:我们绑过、还没截止的任务,每个作品的平台分类和评定,有没有同类型条款
account_status运营平台:账号限制和解除时间、提交节奏、像塑登录态、资料和数字、收入、等级成长、拍视频激励、精选作者计划、最近 50 条站内信
changes_since运营平台:从「已经告诉过用户」的进度往后的变化(阶段、评定、通知、账号限制、登录态),带一句话和要不要用户动手
changes_ack运营平台:告诉完用户后把进度推到 changes_since 返回的 up_to,所有 agent 对话共用
pipeline_refresh运营平台:现在重取一次作品列表、站内信和到点的数据卡片,5 分钟最多一次
effect_detail任意已上线特效或模板的详情(按 app_effect_id,别人的也行):等级代码、累计投稿 / 点赞 / 评论、喜爱度、男女比例、受众、风格、平台判定的类型、来自哪个工具、流量状态、用到的编辑器能力 functions、作者及等级、几条示例视频(图标和视频给短引用)
effect_videos用一个特效拍的热门抖音视频(标题、作者、点赞、跟拍、抖音视频 ID、封面和视频引用)和累计点赞、跟拍
effect_search移动版搜索:按关键词搜全平台已上线的特效(最多 100 条)或模板(kind),按 cursor 翻页,每页最多 20;顺序是服务端定的(偏向累计投稿高的老特效),接口不认排序参数
inspiration_search / tutorial_search移动版搜索:按关键词搜灵感、官方教程(字段同 inspiration_list、tutorials_list)
tutorials_list官方教程:全部分类(特效、模板两组)和一个分类或全部教程(标签、学习人数、飞书文档链接(要登录,读不到正文)、视频引用),按 offset 分页
shoot_scripts官方拍摄脚本(教你用特效拍什么视频,带完整做法、播放数和拍摄数、示范视频引用),按标签代码筛选、按 offset 分页
music_categories抖音音乐库的分类
music_list / music_search一个分类的歌、按关键词搜歌(带版权标记),按 cursor 翻页

| makeup_layers | 读工程目录里的全部美妆层(妆容层、旧版 FaceMaskDY 妆容层和美瞳),逐层给出区域、部位、混合模式、平均色、着色、贴图色乘着色的 tinted_color(没有实测核对)、男女强度和实际生效的不透明度(单独加的层:面板不透明度 × 男女强度 × 外部强度;整套美妆子项由 AI 脸接管,只按男女强度 × 外部强度)、表面质地(水润、珠光等)、只作用于哪几张脸、是否生效;部位先看层名,看不出时按贴图像素和混合模式判断(滤色等只会提亮的层

冒頭だけを表示しています。続きはリポジトリで読めます