XinYu.
導覽
開發者
MCPCLI
語言
MCP

連線 XinYu AI MCP

把 XinYu AI 的影像、影片、音訊、文本生成能力,以及畫布的檢視與整理,接入 Claude、Cursor、Windsurf、Cline 等任意支援 MCP 的 AI Agent。讓你的 Agent 直接「動手」生成內容,用的是你自己的帳戶和額度。

概述

MCP(Model Context Protocol)是 AI Agent 呼叫外部工具的標準協議。XinYu AI 的 MCP server 把平臺的生成介面包裝成一組帶型別的工具,你的 Agent 無需學習任何自定義命令,即可呼叫。

你的額度

呼叫計費與網頁端同價同賬本,用你自己的心點。

安全驗證

使用者級 API Key,可設為只讀、可隨時吊銷,絕不暴露第三方金鑰。

36 個工具

影像、影片、音訊、文本、編輯、任務與畫布讀寫,一應俱全。

前置要求:Node.js 18 或更高版本,以及一個 XinYu AI 帳戶。

獲取 API Key

1

登入 XinYu AI

訪問 xinyuai.app 並登入你的帳戶。
2

開啟「個人設定」→「開發者 API 金鑰」

點選右上角頭像,選擇「個人設定」,在頁面下方找到「開發者 API 金鑰」。
3

建立並複製金鑰

輸入金鑰名稱,點選「建立金鑰」。明文金鑰(xys_live_...)只顯示一次,請立即複製儲存。只想讓工具查詢、不讓它花心點?建立前先勾選「只讀金鑰(只能查詢,不能生成)」。
API Key 等同於你的帳戶許可權,可消耗你的心點餘額。請妥善保管,不要提交到程式碼倉庫或公開分享。若洩露,請立即在同一位置吊銷。

安裝

無需手動安裝——下面的客戶端配置會用 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 Key。

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文生圖 / 圖生圖,可掛參考圖、一次出多張(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_final把 Seedance 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 影片(需要原任務的 task id)
xinyu_enhance影像高畫質放大與增強(Topaz),可選人臉增強
xinyu_remove_bg摳圖 / 去背景,輸出透明 PNG
xinyu_split_layers拆圖層(Seedream 5.5):底圖 + 透明圖層,返回每層的名字和位置;按上限先扣,沒拆出來的自動退回
xinyu_outpaint影像外繪:向上 / 右 / 下 / 左按畫素外擴畫面

任務

xinyu_get_job查詢單個任務的狀態與產物
xinyu_wait_for_job一次呼叫等到任務結束並返回產物——等待超時後找回結果的首選,不要重新生成
xinyu_list_jobs列出最近任務,可按狀態 / 畫布過濾(忘了 jobId 就用 status: RUNNING 找回)

帳戶與模型

xinyu_balance查詢心點餘額
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(預設原地址不能直接當參考,不扣費)

檢視畫布

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_nodes給兩個節點連上參考線,源節點成為目標節點的參考輸入(僅個人畫布)
xinyu_disconnect_nodes移除節點間的參考線;其餘參考的位置會前移,而 @圖片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 找,別重複上傳。

開始使用

配置好後,直接用自然語言對你的 Agent 說話即可,例如:

💬 「用 nano-banana-2.1 生成一張賽博朋克城市,2K,16:9」

💬 「用 Seedance 2.0 做一段 5 秒的海浪影片」

💬 「查一下我還剩多少心點」

💬 「在『夏日海報』畫布裡找出所有帶『海邊』的圖,再幫我整理排版」

Agent 會自動選擇 xinyu_generate_image / xinyu_generate_video / xinyu_balance 等工具(查詢畫布內容、整理排版則用 xinyu_find_nodes / xinyu_arrange_canvas),等待完成後把結果返回給你。

常見問題