kelivo-image-mcp

一个远程 MCP 服务，让 Kelivo 里的普通聊天模型通过调用工具来生图。图片会被服务自己托管一份，并以 Markdown 直链返回，这样模型可以把它写进回复正文，客户端就能直接铺开显示，而不是折叠在「工具调用」卡片里。

两套后端：

同时实现两种传输方式，兼容大多数 MCP 客户端：

• 旧版 HTTP+SSE：GET /sse + POST /messages

• Streamable HTTP：POST /mcp

实际上 /、/mcp、/sse 三个路径都能用，GET 当 SSE、POST 当 Streamable HTTP，自动判断。

环境变量

部署（Render，手机可完成）

部署完得到形如 https://kelivo-image-mcp.onrender.com 的地址。访问根路径可以看到版本号和各项配置是否就绪。

在 Kelivo 里接入

添加远程 MCP，URL 填：

https://<你的域名>.onrender.com/mcp?token=<你的 MCP_AUTH_TOKEN>

然后用一个支持工具调用的聊天模型，开启这个 MCP。

NAI 生图的选项流程

nai_generate 的参数都有默认值，但站点选项较多，推荐让模型先调 nai_options 把选项列成编号列表给用户挑：

• 风格预设 preset：fresh 韩漫小清新 / anime 动漫同人 / 2.5d 2.5D唯美 / galgame GalGame风 / custom 自定义

• 画幅 size：竖图 / 横图 / 方图（各 1 点），2K 系列 15 点，4K 系列 25 点

• 采样器 sampler：k_dpmpp_2m_sde 等 6 种

• 参数：steps 1-28、scale 1-20、cfg 0-1

• 数量 n：1 / 2 / 4

单次消耗超过 4 点时，nai_generate 不会直接扣费，而是返回一条提示要求模型先向用户说明总消耗，用户同意后再带 confirmed=true 调用。中文描述可以先用 nai_prompt_convert 转成英文 tag，这一步不消耗点数。

说明

• 所有 key 只放在环境变量里，不写进代码。

• 不设 MCP_AUTH_TOKEN 的话，任何拿到 URL 的人都能调用并消耗你的额度。

• 图片存在内存里，最多 60 张、保留 12 小时；Render 免费实例休眠或重新部署后图片链接会失效，想长期保存请及时下载。

• Render 免费实例闲置 15 分钟休眠，唤醒约需 1 分钟，所以第一次生图可能偏慢。

• 仓库里的 main.ts 是早期的 Deno 版本，功能较旧，仅作保留。