MCP Server

把 PhoenixAI 的生图能力接进支持 MCP 的 AI 编程工具。不需要源码，Node.js ≥ 18 即可。

安装

一键安装

curl -fsSL https://ai.suzatei.com/dl/install.sh | bash -s -- --mcp

或用 npm 装安装包（始终指向最新版）

npm install -g https://ai.suzatei.com/dl/phoenixai-mcp-latest.tgz

安装后全局命令为 phoenixai-mcp。

客户端配置

只需要配一个 API Key。

Claude Code

claude mcp add phoenixai \
  -e PHOENIX_BASE_URL=https://ai.suzatei.com \
  -e PHOENIX_MODEL_KEY=sk-你的Key \
  -- phoenixai-mcp

Cursor（~/.cursor/mcp.json）、Claude Desktop（claude_desktop_config.json）等使用 mcpServers 格式的客户端

{
  "mcpServers": {
    "phoenixai": {
      "command": "phoenixai-mcp",
      "env": {
        "PHOENIX_BASE_URL": "https://ai.suzatei.com",
        "PHOENIX_MODEL_KEY": "sk-..."
      }
    }
  }
}

Codex（~/.codex/config.toml）

[mcp_servers.phoenixai]
command = "phoenixai-mcp"

[mcp_servers.phoenixai.env]
PHOENIX_BASE_URL = "https://ai.suzatei.com"
PHOENIX_MODEL_KEY = "sk-..."

其他客户端的配置字段名略有差异（例如 VS Code 用 servers），按其 MCP 文档把上面的 command 和 env 填进去即可。

可选：要绑定账号历史时，改用或追加 PHOENIX_TOKEN=<access_token>（见认证）。

配置后重启 IDE。对话里说「用 PhoenixAI 生成一张…」即可触发。

可用工具

工具	说明
`phoenix_list_models`	列出可用模型（默认精简）；传 `model` 查某个模型的完整参数
`phoenix_generate_image`	文生图，可 `wait: false` 只拿任务 id
`phoenix_get_generation`	查询任务状态与结果 URL

参数说明

phoenix_list_models

字段	必填	说明
`model`	否	传模型 id，只返回该模型的完整参数定义（含高级参数、可选值、默认值）
`full`	否	`true` 时返回完整目录，体积很大，通常不需要

不传参数时返回精简目录：每个模式只有 model、label、note、needsRefs（是否需要参考图）和 basicParams（基础参数名），AI 先用它选模型，需要细节时再传 model 查询，这样不会占用大量上下文。

phoenix_generate_image

字段	必填	说明
`model`	是	先用 `phoenix_list_models` 查到的 model id（`needsRefs` 为 true 的模式不支持）
`prompt`	是	画面描述
`wait`	否	默认 `true`，最长等约 180 秒；`false` 时立即返回任务 id
`params`	否	模型私有参数（分辨率等，字段见 `phoenix_list_models` 的 `basicParams`，完整定义传 `model` 查询）

返回的结果 URL 是完整地址，可直接下载；文件只保留一段时间（默认约 6 小时）。生成较慢的模型建议 wait: false，再用 phoenix_get_generation 查询。

能做什么，不能做什么

MCP 目前只有上面 3 个工具，只覆盖纯文生图：

需要参考图的编辑类模式 → 用 HTTP API
调用 LLM 对话 → 直接用 LLM API（OpenAI 兼容，大多数工具原生支持，无需 MCP）
让 AI 帮你写集成代码 → 装 Skill

卸载

npm uninstall -g phoenixai-mcp

本地开发（仅贡献者）

若你克隆了源码仓库，可直接指向源码入口：

claude mcp add phoenixai -- node /path/to/phoenix-tools/mcp-server/index.js