XinYu.
ナビゲーション
開発者
MCPCLI
言語
MCP

MCP で XinYu AI に接続する

XinYu AI の画像・動画・音声・テキスト生成機能とキャンバスの参照・整理を、Claude、Cursor、Windsurf、Cline など MCP 対応のあらゆる AI エージェントから使えるようにします。エージェントが自分で手を動かしてコンテンツを生成し、使われるのはご自身のアカウントと残高です。

概要

MCP(Model Context Protocol)は、AI エージェントが外部ツールを呼び出すための標準プロトコルです。XinYu AI の MCP サーバーは、プラットフォームの生成 API を型付きのツール群としてまとめているので、エージェントは独自のコマンドを覚えることなく呼び出せます。

あなたの残高

料金と台帳は Web 版と同じで、ご自身の Xinポイントが使われます。

安全な認証

ユーザー単位の API キーで、読み取り専用にすることも、いつでも無効化することもできます。外部プロバイダーのキーが公開されることはありません。

36 個のツール

画像・動画・音声・テキスト・編集・ジョブ・キャンバスの参照と編集まで、すべてそろっています。

前提条件:Node.js 18 以上と XinYu AI アカウント。

API キーを取得する

1

XinYu AI にログイン

xinyuai.app にアクセスして、アカウントにログインします。
2

「設定」→「開発者 API キー」を開く

右上のアバターをクリックして「設定」を選び、ページの下のほうにある「開発者 API キー」を探します。
3

キーを作成してコピー

キーの名前を入力して「キーを作成」をクリックします。平文のキー(xys_live_...)は一度しか表示されないので、すぐにコピーして保管してください。ツールに照会だけさせて Xinポイントを使わせたくない場合は、作成前に「読み取り専用キー(照会のみ、生成は不可)」にチェックを入れます。
API キーはアカウントと同等の権限を持ち、Xinポイントを消費できます。秘密にしておき、リポジトリにコミットしたり、公開したりしないでください。漏えいした場合は、すぐに同じ場所で無効化してください。

インストール

手動でのインストールは不要です。下のクライアント設定が npx 経由で最新版を自動的に取得して実行します。明示的にインストールする場合:

bash
# No install needed — the client config below runs it via npx.
# To install the command explicitly:
npm install -g @xinyuai/mcp-server
# → exposes the "xinyu-mcp" command

そのまま次のステップに進み、下の JSON をクライアントの設定に貼り付けてください。

クライアントを設定する

下の設定を、お使いのクライアントの MCP 設定に追加し、パスと API キーを置き換えてください。

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

json
{
  "mcpServers": {
    "xinyu": {
      "command": "npx",
      "args": ["-y", "@xinyuai/mcp-server"],
      "env": {
        "XINYU_API_KEY": "xys_live_xxxxxxxxxxxxxxxx",
        "XINYU_BASE_URL": "https://xinyuai.app"
      }
    }
  }
}

Cursor / Windsurf / Cline

同じ形式で設定します(例:Cursor の .cursor/mcp.json):

json
{
  "mcpServers": {
    "xinyu": {
      "command": "npx",
      "args": ["-y", "@xinyuai/mcp-server"],
      "env": { "XINYU_API_KEY": "xys_live_xxxx" }
    }
  }
}
XINYU_BASE_URL の既定値は https://xinyuai.app なので、通常は設定不要です。設定後にクライアントを再起動すると、xinyu_* ツールが表示されます。

利用できるツール

生成

xinyu_generate_imageテキストから画像 / 画像から画像。参照画像を付けたり、1 回で複数枚を生成したりできます(Nano Banana / GPT Image / SeeDream / Grok Imagine / Wan など)
xinyu_generate_videoテキストから動画 / 画像から動画 / 参照から動画。開始・終了フレームと、参照画像・動画・音声に対応(Kling / Seedance / Wan / Grok / MiniMax / HappyHorse など)。Seedance 2.5 は draft: true で先にドラフトを生成できます
xinyu_generate_video_finalSeedance 2.5 のドラフトから 1080p または 4K の本番動画を生成(ドラフトの jobId を渡します。料金は選んだ解像度の生成として計算されます)
xinyu_generate_audioテキスト読み上げ(ElevenLabs)。または Seed Audio で、プロンプトから音声・音楽・効果音を生成(参照音声は最大 3 つまで、音色のクローンに使えます)
xinyu_generate_textテキスト LLM。画像・動画を視覚的な文脈として渡せます(Gemini / Claude / DeepSeek / GLM / Qwen)。結果は同期で返るため、ポーリングは不要です

編集・高画質化

xinyu_image_edit指示による画像編集(描き直し・消去)
xinyu_video_edit指示による動画編集(Kling O3 の動画から動画。元動画は高さ 720px 以上)
xinyu_video_action以前に生成した Grok 動画を高解像度化・延長(元のタスク ID が必要)
xinyu_enhance画像の高解像度化と高画質化(Topaz)。顔の補正も選べます
xinyu_remove_bg背景除去。透過 PNG を返します
xinyu_split_layers画像をベースと透過レイヤーに分解(Seedream 5.5)。各レイヤーの名前と位置を返します。上限分を先に引き落とし、未使用分は返金
xinyu_outpaintアウトペイント:画像を上・右・下・左にピクセル単位で拡張

ジョブ

xinyu_get_jobジョブ 1 件のステータスと成果物を取得
xinyu_wait_for_jobジョブが終わるまで 1 回の呼び出しで待ち、成果物を返す。待機がタイムアウトしたあとの取得に最適で、再生成はしないでください
xinyu_list_jobs最近のジョブを一覧表示(ステータスやキャンバスで絞り込み可。jobId を失くしたときは status: RUNNING で探せます)

アカウントとモデル

xinyu_balanceXinポイント残高を取得
xinyu_list_models利用できるモデルとその機能を一覧表示(出力タイプで絞り込み可)。モデル ID の基準になります
xinyu_estimate_price実行前に画像生成の料金を見積もる(画像のみ)。実際の課金と同じ関数で計算するので、見積もり額がそのまま請求額です

プロジェクトとファイル

xinyu_list_projects自分のプロジェクト(キャンバス)を一覧表示し、project_id を取得
xinyu_create_project空のキャンバスを新規作成し、project_id を返す
xinyu_delete_project不要になったキャンバスを削除します。削除できるのは空のキャンバス(ノード・生成結果・実行中のタスクがない)のみで、それ以外はキャンバス上で削除してください
xinyu_uploadローカルの画像・動画・音声をアップロードして、生成に使える URL を取得(キャンバスへの配置も選べます)
xinyu_list_assetsキャンバス上にある画像・動画・音声を検索・一覧表示し、そのまま再利用できる URL を取得(アップロードの前にまずここで探します)
xinyu_list_presets心宇プリセット:衣装 1407 点・人形ポーズ 288 種(5 アングル)。分類・アングル・番号で検索(読み取り専用・無料)
xinyu_import_presetプリセットを自分の素材として保存し、参照画像に使える URL を返す(プリセットの元 URL はそのまま参照に使えません・無料)

キャンバスの参照

xinyu_read_canvasキャンバスの概要:ノードと接続の総数、タイプ別・ステータス別の件数。どんなに大きなキャンバスでも安全です
xinyu_find_nodesキャンバスのノードを検索:タイトルとプロンプト全文、タイプ、ステータス、グループ、位置で絞り込み。総数は常に正確に報告します
xinyu_inspect_nodes最大 8 ノードの詳細を取得:プロンプト全文、パラメーター、位置、接続
xinyu_read_node_promptノードのプロンプト全文を分割して取得(非常に長いプロンプト向け)

キャンバスの編集

xinyu_arrange_canvasキャンバスを整理:散らばったコンテンツノードをグリッドに並べます(グループとメモはそのまま)
xinyu_create_node生成せずにノードを追加します。プロンプト・モデル・パラメータ・参照接続を設定するだけで実行せず、クレジットも消費しません。キャンバスで確認してから生成します(個人キャンバスのみ)
xinyu_rename_nodeノードのタイトルを変更(変わるのはタイトルだけで、プロンプト・参照・パラメーター・生成結果はそのまま。個人キャンバスのみ)
xinyu_update_node_paramsノードの生成パラメーター(モデル、比率、解像度、長さなど)をその場で変更。下書きとして保存するだけで、再生成もポイント消費もありません(個人キャンバスのみ)
xinyu_connect_nodes2 つのノードの間に参照の接続を引く(元ノードが先ノードの参照入力になります。個人キャンバスのみ)
xinyu_disconnect_nodesノード間の参照の接続を削除(残りの参照の位置が繰り上がり、@Image N は位置で番号付けされます。個人キャンバスのみ)
xinyu_delete_nodesノードとその接続を削除(元に戻せません)。生成結果(課金済み)があるノードや生成中のノードは、明示的に確認しないと削除されません(個人キャンバスのみ)

生成系ツールは、既定でジョブの完了まで待ってから成果物の URL を返します(wait: false を渡すと jobId をすぐに返します)。既定の最大待機時間は、画像・音声などが 300 秒、動画系が 2400 秒で、wait_timeout_s で変更でき、最大 3600 秒です。タイムアウトは失敗ではありません。ジョブはサーバー側で実行を続けているので、xinyu_wait_for_job(または xinyu_get_job)で結果を取得し、再生成はしないでください。

画像・動画・音声系のツール(編集・高解像度化・背景除去・アウトペイントを含む)の結果は、必ずいずれかのキャンバスに属するため、project_id が必須です。まず xinyu_list_projects で既存のプロジェクトを探すか、xinyu_create_project で新しく作成し、取得した project_id を渡して生成します。結果は既定でノードとしてそのキャンバスに配置され(place_on_canvas の既定値は true。位置は canvas_x / canvas_y で指定できます)、次にキャンバスを開いたとき、または更新したときに表示されます。ユーザーがまだキャンバスを指定していない場合は、新規作成するか既存のキャンバスを使うかを先に確認してください。テキストツール xinyu_generate_text では project_id は不要です。
生成ツールが受け付けるのは URL だけで、ローカルパスや base64 は使えません。ローカルファイルはまず xinyu_upload で URL にします。キャンバス上にすでにある素材は、xinyu_list_assets で探して再利用し、重複してアップロードしないでください。

使い始める

設定が済んだら、あとはエージェントに自然な言葉で話しかけるだけです。例:

💬 「nano-banana-2.1 で、サイバーパンクの都市を 2K・16:9 で生成して」

💬 「Seedance 2.0 で、5 秒の波の動画を作って」

💬 「Xinポイントの残りを確認して」

💬 「『夏のポスター』キャンバスから『海辺』を含む画像をすべて探して、レイアウトも整えて」

エージェントは xinyu_generate_image / xinyu_generate_video / xinyu_balance などのツールを自動で選び(キャンバスの検索や整理には xinyu_find_nodes / xinyu_arrange_canvas)、完了を待ってから結果を返します。

よくある質問