NovelAI MCP

MCP（Model Context Protocol，模型上下文协议）是聊天客户端调用外部工具的协议。NovelAI MCP 为客户端提供本站的绘图工具；配置完成后，可以在聊天中描述想要的画面，由聊天模型整理需求并调用工具，生成的图片会显示在支持图片显示的客户端中。

适合以下使用场景：

• 边聊天边调整构图、人物、服装、动作和画面风格。
• 使用自然语言描述需求，不需要手动编写完整的绘图请求参数。
• 在同一个聊天客户端中同时使用文本模型和 NovelAI 绘图能力。
• 让聊天模型根据上下文和所选模型的语言规则整理提示词后再调用绘图工具。

支持范围

NovelAI MCP 提供基础文生图，即根据文字描述生成图片。可设置模型、正向提示词、负向提示词、尺寸、采样步数、提示词引导强度、采样器和随机种子。每次调用生成一张 PNG 图片。

不支持基于原图修改、指定区域重绘、分别设置多个角色提示词或上传参考图。

模型、预算与图片返回

绘图工具支持 nai-diffusion-4-full、nai-diffusion-4-5-full、nai-diffusion-4-5-curated、nai-diffusion-5-full、nai-diffusion-5-curated，默认使用 V4.5 Full。宽高须各为 64～4096 内的 64 倍数，且总像素不超过 3145728；步数（生成迭代次数）支持 1～50。提示词语言要求见提示词限制。

Anlas 是 NovelAI 的点数单位，本站生图费用包含基础费用和实际点数费用。调用前应确认接受所选模型和参数对应的费用，金额以主站模型广场的模型、分组定价和使用日志为准，详见费用说明。

需要控制点数消耗时，可以要求聊天模型设置绘图工具的 max_anlas。它是可选的非负整数，限制本次生成的额外 Anlas；省略表示不设上限，0 表示不允许额外点数，但仍收基础费用。因此它不是单次总金额上限。结果中的 anlas_used 表示本次实际额外点数，不含基础费用。

response_format 决定图片返回方式。表中的 ImageContent 是 MCP 标准图片消息，包含图片内容而不是链接：

值	返回内容	适用场景
url（默认）	公开图片 URL	方便聊天模型在最终回复中使用 Markdown 展示图片。
base64	标准 MCP ImageContent	客户端或模型需要直接接收图片内容。
both	URL 与 ImageContent	聊天模型支持视觉输入，且后续需要查看或分析生成结果。

URL 通常不会自动成为模型的视觉输入；不支持视觉输入的模型无需选择 both。公开 URL 可由持有链接的人访问，应自行保存需要长期保留的图片。

使用前准备

使用 NovelAI MCP 需要：

1. 一个支持 Streamable HTTP MCP（通过 HTTP 连接远程工具服务）和自定义请求头的聊天客户端。
2. 一个可以访问 NovelAI 模型所在分组的本站 API Key。
3. 一条可以正常访问的本站线路。

MCP 端点由线路网址加 /mcp 组成。例如：

https://api.taleapi.asia/mcp

如果使用其他线路，也应在该线路网址后添加 /mcp。线路地址见线路与接口。

认证信息通过自定义请求头填写：

配置项	填写内容
传输类型	Streamable HTTP
服务器地址	https://站点线路地址/mcp
请求头名称	Authorization
请求头值	Bearer sk-xxxxxxxx

Bearer 后必须有一个空格

请求头值由 Bearer、一个英文空格和完整 API Key 组成。不要添加引号，也不要把 API Key 写入服务器地址。

确认 Key 可以访问 NovelAI 模型

填入的 API Key 必须能够访问 NovelAI 模型所在分组。没有对应分组权限时，MCP 可以连接，但绘图工具调用会失败。

在 RikkaHub 中配置

以下步骤适用于 Android 版 RikkaHub。开始前，请先安装 RikkaHub，并准备好本站 API Key。

1. 打开 MCP 管理页面

进入 RikkaHub 的设置页面，选择 MCP，然后点击 MCP 管理页面右上角的 + 添加服务器。

2. 填写服务器配置

服务器名称可以自行填写，例如 nai。其余配置如下：

1. 传输协议选择 Streamable HTTP，不要选择 SSE。
2. 服务器地址填写当前线路的网址，并在末尾添加 /mcp，例如 https://api.taleapi.asia/mcp。
3. 添加一个自定义请求头，请求头名称填写 Authorization。
4. 请求头值填写 Bearer sk-xxxxxxxx，将示例 Key 替换为自己的完整 API Key。
5. 保存配置。

3. 在聊天中启用 MCP

回到聊天页面，点击输入框附近的 +，进入 MCP 服务器，然后启用刚才添加的服务器。

4. 发送绘图需求

启用后，可以直接在聊天框中描述想要的图片。例如：

画一张横向动漫插画：雨后的城市天台，一名黑发少女撑着透明雨伞，远处有霓虹灯，冷色调。

当前聊天模型会根据需求决定是否调用 NovelAI 绘图工具。为了提高调用成功率，建议在消息中明确写出“生成图片”“画一张图”或“调用 NovelAI 绘图工具”。

工具是否调用由当前聊天模型决定

NovelAI MCP 为聊天模型提供绘图工具，但具体何时调用、如何整理提示词，取决于 RikkaHub 中当前选择的聊天模型。模型未调用工具时，请明确要求其使用 NovelAI 绘图工具生成图片。

使用建议

• 描述主体、场景、构图、动作、服装、光线和画面风格，聊天模型更容易整理出准确的绘图请求。
• 需要调整图片时，直接说明需要保留和修改的内容，再要求重新生成。
• 不确定尺寸或提示词写法时，查阅尺寸示例和提示词限制。

常见问题

MCP 无法连接

依次确认：

• 传输协议是否选择了 Streamable HTTP。
• 服务器地址是否以 /mcp 结尾。
• 使用的线路当前是否可以访问。
• 自定义请求头名称是否为 Authorization。
• 请求头值中的 Bearer 后是否有一个英文空格。

MCP 可以连接，但生图失败

确认填写的 API Key 完整有效，并且可以访问 NovelAI 模型所在分组。也可以在模型监控中查看当前模型状态。

聊天模型只回复文字，没有生成图片

在消息中明确要求调用 NovelAI 绘图工具。如果仍未调用，请更换工具调用能力更稳定的聊天模型，并确认当前会话已经启用对应的 MCP 服务器。

工具已调用，但客户端没有显示图片

默认返回图片 URL，客户端需支持 Markdown 图片显示；选择 base64 或 both 时，还需支持 MCP ImageContent。RikkaHub 和 Kelivo 已通过可用性测试；其他客户端能否使用，需确认其远程工具调用和图片显示能力，不能仅凭标注“支持 MCP”判断。

仍无法解决问题

遇到无法判断的连接或调用错误，可以加入 QQ 讨论群 901635977 询问。反馈时请提供使用的客户端、MCP 服务器地址、错误信息和相关截图；请先遮挡完整 API Key。