连接 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 正片（传样片的 jobId，按 1080p 正片计费）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_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_upload上传本地图片 / 视频 / 音频，得到可用于生成的 URL，可选同时放到画布上xinyu_list_assets搜索 / 列出画布里已有的图片、视频、音频，拿到可直接复用的 URL（上传之前先查它）查看画布
xinyu_read_canvas画布概览：节点 / 连线总数与各类型、各状态的计数，画布再大也安全xinyu_find_nodes在画布里搜索节点：按标题与完整提示词、类型、状态、分组、位置过滤，并如实报告总数xinyu_inspect_nodes读取至多 8 个节点的完整详情：提示词、参数、位置与连线xinyu_read_node_prompt分段读取节点的完整提示词（提示词很长时用）修改画布
xinyu_arrange_canvas整理画布：把散落的内容节点按网格排好（分组与批注不动）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 生成一张赛博朋克城市，2K，16:9」
💬 「用 Seedance 2.0 做一段 5 秒的海浪视频」
💬 「查一下我还剩多少心点」
💬 「在『夏日海报』画布里找出所有带『海边』的图，再帮我整理排版」
Agent 会自动选择 xinyu_generate_image / xinyu_generate_video / xinyu_balance 等工具（查找画布内容、整理排版则用 xinyu_find_nodes / xinyu_arrange_canvas），等待完成后把结果返回给你。