MCP で XinYu AI に接続する
XinYu AI の画像・動画・音声・テキスト生成機能とキャンバスの参照・整理を、Claude、Cursor、Windsurf、Cline など MCP 対応のあらゆる AI エージェントから使えるようにします。エージェントが自分で手を動かしてコンテンツを生成し、使われるのはご自身のアカウントと残高です。
概要
MCP(Model Context Protocol)は、AI エージェントが外部ツールを呼び出すための標準プロトコルです。XinYu AI の MCP サーバーは、プラットフォームの生成 API を型付きのツール群としてまとめているので、エージェントは独自のコマンドを覚えることなく呼び出せます。
料金と台帳は Web 版と同じで、ご自身の Xinポイントが使われます。
ユーザー単位の API キーで、読み取り専用にすることも、いつでも無効化することもできます。外部プロバイダーのキーが公開されることはありません。
画像・動画・音声・テキスト・編集・ジョブ・キャンバスの参照と編集まで、すべてそろっています。
API キーを取得する
XinYu AI にログイン
「設定」→「開発者 API キー」を開く
キーを作成してコピー
インストール
手動でのインストールは不要です。下のクライアント設定が npx 経由で最新版を自動的に取得して実行します。明示的にインストールする場合:
# 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
{
"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):
{
"mcpServers": {
"xinyu": {
"command": "npx",
"args": ["-y", "@xinyuai/mcp-server"],
"env": { "XINYU_API_KEY": "xys_live_xxxx" }
}
}
}利用できるツール
生成
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)で結果を取得し、再生成はしないでください。
使い始める
設定が済んだら、あとはエージェントに自然な言葉で話しかけるだけです。例:
💬 「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)、完了を待ってから結果を返します。