XinYu.
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，可随时吊销，绝不暴露第三方密钥。

14 个工具

图像、视频、音频、文本、编辑与任务查询一应俱全。

前置要求：Node.js 18 或更高版本，以及一个 XinYu AI 账户。

获取 API Key

1

登录 XinYu AI

访问 xinyuai.app 并登录你的账户。
2

打开设置 → API Keys

点击左下角头像进入设置，找到「API Keys」面板。
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，本地开发可设为 http://localhost:3001。配置后请重启客户端，xinyu_* 工具即会出现。

可用工具

xinyu_generate_image文生图 / 图生图
xinyu_generate_video文生视频（Kling / Seedance / WAN / Grok / LTX）
xinyu_generate_audio文字转语音（ElevenLabs）
xinyu_generate_text文本 LLM（Gemini / ChatGPT / DeepSeek）
xinyu_enhance图像高清放大（Topaz）
xinyu_remove_bg抠图 / 去背景
xinyu_outpaint图像扩展（外绘）
xinyu_image_edit指令式图像编辑
xinyu_video_edit视频改写（Kling O3）
xinyu_video_action视频放大 / 延长
xinyu_get_job查询单个任务状态
xinyu_list_jobs列出最近任务
xinyu_balance查询心点余额
xinyu_list_models列出可用模型
xinyu_list_projects列出我的项目（画布），拿到 project_id
xinyu_create_project新建一个空画布，返回 project_id

生成类工具默认会轮询到任务完成再返回素材 URL（可用 wait: false 立即返回 jobId，之后用 xinyu_get_job 查询）。视频生成较慢，可调大 wait_timeout_s。

每次生成都必须属于一个画布：所有生成工具的 project_id 为必填。先用 xinyu_list_projects 找现有项目，或 xinyu_create_project 新建一个，拿到 project_id 再生成。图片 / 视频默认作为节点落到该画布（place_on_canvas 默认 true，可选 canvas_x / canvas_y 指定位置），下次打开 / 刷新画布即可看到。若用户还没指定画布，应先询问要新建还是用哪个已有画布。

开始使用

配置好后，直接用自然语言对你的 Agent 说话即可，例如：

💬 「用 nano-banana-2 生成一张赛博朋克城市，2K，16:9」

💬 「用 Seedance 2.0 做一段 5 秒的海浪视频」

💬 「查一下我还剩多少心点」

Agent 会自动选择 xinyu_generate_image / xinyu_generate_video / xinyu_balance 等工具，等待生成完成后把结果 URL 返回给你。

常见问题