Wan27 MCP — AI Image and Video Generation

Wan27 MCP 和 CLI — AI 图像与视频生成

使用你的 wan2-7.io 账户，在终端或 AI 助手中生成图像和视频。MCP 和 CLI 使用与网站相同的额度余额，价格也相同。请在网站上充值。

使用需要有效的付费订阅。 仅购买额度包、免费账户和未付费试用均不符合要求。关闭自动续订的订阅在其付费周期结束前仍可使用。请前往 https://wan2-7.io/pricing/ 升级。

Node 22+、macOS 或 Linux（包括 WSL）。

安装

npm install -g @wan27/cli

使用

wan27 auth login
wan27 account
wan27 models
wan27 estimate --input request.json
wan27 create --input request.json --wait
wan27 download <taskId> --output result.mp4
wan27 auth logout

request.json 示例：

{"modelId":"wan27-text-to-video","prompt":"A paper boat on a rainy street","durationSeconds":5,"resolution":"720p"}

{"modelId":"wan2.7-image","prompt":"A paper crane on a desk","resolution":"2K"}

对于图生视频，请上传首帧并传入其 URL：

wan27 upload frame.png        # {"url":"https://..."}

{"modelId":"wan27-image-to-video","prompt":"The crane takes off","imageUrl":"https://..."}

wan27 model <modelId> 会打印所有选项及其 JSON Schema。

create 会在 stderr 上打印请求 ID。发生网络错误后，使用 --request-id <id> 重新运行，会返回同一任务，且绝不会重复扣费。失败的任务会自动退款。wait 超时只会停止等待；任务仍会继续运行。

凭据存储在 macOS Keychain 中；或使用 --credential-store file 将凭据存储在私有文件中（目录权限为 0700，文件权限为 0600）。WAN27_CONFIG_DIR 可更改该目录。WAN27_ACCESS_TOKEN 可接受预先签发的 API 令牌，用于自动化。登出会撤销此连接；更改网站密码会撤销所有连接。

连接助手（本地 MCP）

使用 wan27 auth login 登录一次，然后注册 stdio 服务端：

codex mcp add wan27 -- wan27 mcp
claude mcp add wan27 -- wan27 mcp

工具：account_status、list_models、get_model、estimate_generation、generate_image、generate_video、list_tasks、get_task。

登录后，支持 JSON 配置的客户端可通过 npx 启动同一个 stdio 服务端：

{
  "mcpServers": {
    "wan27": {
      "command": "npx",
      "args": ["-y", "@wan27/cli", "mcp"]
    }
  }
}

生成前，请先查看账户状态并估算费用。图像和视频生成会消耗你的网站额度。

文档与支持

• Wan27 网站
• MCP 设置和客户端说明
• CLI 安装
• MCP 和 CLI 工作流指南
• 订阅方案
• 公共客户端分发与问题跟踪

运行此公共分发版本

此仓库包含 @wan27/[email protected] 的可读 JavaScript 可执行文件。 托管服务由 wan2-7.io 运营。

npm ci --ignore-scripts
node dist/cli.mjs --help
node dist/cli.mjs auth login
node dist/cli.mjs mcp

许可证与来源

MIT。发布来源信息请参阅 PROVENANCE.md。 该可执行文件与 0.1.1 版本完全相同。0.1.3 版本更新了 GitHub 仓库和 MCP Registry 命名空间，使其归属 NotUsingGithub 账户。

用于目录检查的容器

docker build -t wan27-mcp .
docker run --rm -i wan27-mcp

此容器以非 root 用户身份运行与 npm 包相同的固定版本客户端分发，并使用必需的 mcp 子命令。由于 Linux 容器无法使用 macOS Keychain，因此会明确选择私有文件凭据存储；空容器不包含凭据。它通过 stdin 接收 MCP JSON-RPC，并通过 stdout 写入协议响应。MCP 初始化和 tools/list 无需账户或令牌，也不会创建媒体或消耗额度。调用账户或生成工具需要经过授权的 Wan27 账户；生成仍需要付费订阅，并会消耗网站额度。

构建过程只会复制分发文件和公开元数据，不包含任何凭据或主机配置。请勿在 Dockerfile 或镜像中嵌入令牌。