NovelAI Image MCP

一个 MCP（模型上下文协议） 服务器，把 NovelAI 图像生成 暴露为 AI 智能体可调用的工具 —— Claude Desktop、Cline、自定义智能体以及远程客户端均可接入。

它基于官方 MCP Python SDK v2（MCPServer）构建，让智能体能够通过标准的 MCP 工具接口生成图像（txt2img / img2img / inpaint）、放大、运行 Director 工具（线稿、表情、背景移除等）、使用 ControlNet 标注、推荐标签、编码 vibe、 查询账户订阅信息等。

---

特性

• 11 个 MCP 工具，覆盖完整的 NovelAI 图像 API 接口。

• 两种传输方式：stdio（本地智能体）与 streamable-http（远程 / 多客户端）。

• 双重返回形式：base64 Image 内容块（让智能体直接 看到 图像）以及 保存到磁盘的 PNG 文件（路径以文本形式返回）。

• 异步 + 同步：异步工具处理器 + 一个 typer CLI 用于直接调用。

• uv 管理的 monorepo，MIT 协议，Docker-ready，文档站由 GitHub Pages 托管。

---

入门

---

快速链接

• ⚡ 快速开始 —— 安装、配置并生成你的第一张图像

• 📦 安装指南 —— 从克隆仓库到验证凭据

• 🔧 配置参考 —— 环境变量与默认值

---

项目链接

• 源码: https://github.com/xinvxueyuan/NovelAI-Image-MCP

• Issues: https://github.com/xinvxueyuan/NovelAI-Image-MCP/issues

• License: MIT

• Changelog: https://github.com/xinvxueyuan/NovelAI-Image-MCP/blob/main/CHANGELOG.md

• NovelAI API 文档: https://image.novelai.net/docs/index.html

---

其他章节

工具参考、教程、传输方式、开发指南、API 参考等章节暂仅提供英文版本。请通过页面左下角的语言切换器切换到 English 查看。