kelivo-image-mcp
Remote MCP server that enables Kelivo chat models to generate images via tool calls, supporting OpenAI-compatible relay and NovelAI backends, and returning images as Markdown links or native image blocks.
README
kelivo-image-mcp
一个远程 MCP 服务,让 Kelivo 里的普通聊天模型通过调用工具来生图。图片会被服务自己托管一份,并以 Markdown 直链返回,这样模型可以把它写进回复正文,客户端就能直接铺开显示,而不是折叠在「工具调用」卡片里。
两套后端:
| 后端 | 工具 | 说明 |
|---|---|---|
| OpenAI 兼容中转站 | generate_image |
grok-imagine / gpt-image / dall-e / flux 等,快,不消耗点数 |
| Nai2API 工作台 | nai_options nai_prompt_convert nai_generate nai_balance |
NovelAI 4.5,质量高,按画幅消耗点数 |
同时实现两种传输方式,兼容大多数 MCP 客户端:
- 旧版 HTTP+SSE:
GET /sse+POST /messages - Streamable HTTP:
POST /mcp
实际上 /、/mcp、/sse 三个路径都能用,GET 当 SSE、POST 当 Streamable HTTP,自动判断。
环境变量
| 变量 | 必填 | 说明 |
|---|---|---|
MCP_AUTH_TOKEN |
是 | 自定义密码,防止别人拿到 URL 白嫖你的额度 |
RELAY_API_KEY |
用中转站生图则必填 | 中转站 key |
RELAY_BASE_URL |
否 | 默认 https://us.shapi.vip |
DEFAULT_IMAGE_MODEL |
否 | 默认 grok-imagine-image |
NAI_TOKEN |
用 NAI 生图则必填 | STA1N- 开头的密钥 |
NAI_BASE_URL |
否 | 默认 https://nai.sta1n.cn |
RETURN_IMAGE_BLOCK |
否 | 设为 1 时额外返回 MCP 原生图片块 |
PUBLIC_BASE_URL |
否 | 覆盖自动识别的对外地址 |
部署(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.5d2.5D唯美 /galgameGalGame风 /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 版本,功能较旧,仅作保留。
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
Neon Database
MCP server for interacting with Neon Management API and databases
E2B
Using MCP to run code via e2b.
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.