連線 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,可設為只讀、可隨時吊銷,絕不暴露第三方金鑰。
影像、影片、音訊、文本、編輯、任務與畫布讀寫,一應俱全。
獲取 API Key
登入 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 Key。
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文生圖 / 圖生圖,可掛參考圖、一次出多張(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摳圖 / 去背景,輸出透明 PNGxinyu_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_idxinyu_create_project新建一個空畫布,返回 project_idxinyu_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)取回結果,不要重新生成。
開始使用
配置好後,直接用自然語言對你的 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),等待完成後把結果返回給你。