AI导哈

NovelAI图像生成MCP服务器

这是一个为AI绘画Agent提供NovelAI图像生成能力的MCP服务器，支持文生图、图生图、标签建议、订阅查询等功能，适用于需要接入NovelAI图像生成服务的开发与集成场景。

  • by hesoyamlp1
  • Python
  • 混合部署
  • 3 星标
  • 更新于
在 GitHub 查看 hesoyamlp1/MCP-NovelAI

使用说明

NovelAI MCP Server

MCP 服务器，为美术 Agent 提供 NovelAI 图像生成能力。V5 使用官方图像 API，旧版模型保留 novelai-python SDK 路径。

V5 扩展（当前源码）

支持 v5-full 与 v5-curated。新增 generate_reference（V4.5 人物/风格参考、V5/V4.5 图生图、Full/V4.5 局部重绘）、generate_v5（文生图、图生图、Full 局部重绘、SSE）、upscale_v5、suggest_tags_v5、prepare_image_v5、inspect_image_v5、account_v5、v5_capabilities、v5_parameter_schema。 调用前读取能力说明；完整参数、图像输入、各角色正负描述与坐标均可配置。两个模型的局部重绘 infill 已实测不支持；当前 V5 也未开放 Vibe Transfer / Precise Reference。 详见 覆盖与真实验收。本轮 V5 代码尚未发布到 PyPI，以下 uvx 安装仍可能得到旧版本；新功能请从本仓库源码运行。

✨ 功能

工具 说明
generate_image 文生图，支持多角色定位、Vibe Transfer、Precise Reference
img2img 图生图，基于已有图片变换
suggest_tags Danbooru 标签搜索/自动补全
check_subscription 查询订阅状态和 Anlas 余额

旧版工具支持模型

名称 模型 ID 说明
v4.5-full nai-diffusion-4-5-full 旧版工具默认模型
v4.5-curated nai-diffusion-4-5-curated 更干净的数据集
v4-full nai-diffusion-4-full V4 Full
v4-curated nai-diffusion-4-curated-preview V4 预览
v3 nai-diffusion-3 V3（老款）

🚀 快速开始

前置条件

  • Python 3.11+
  • NovelAI API Key（以 pst- 开头，从 novelai.net 获取）

方式一：通过 PyPI 安装（推荐）

# 使用 uvx 直接运行（无需手动安装）
NOVELAI_API_KEY=pst-xxx uvx novelai-mcp

# 或者用 pip 安装
pip install novelai-mcp
NOVELAI_API_KEY=pst-xxx novelai-mcp

方式二：从源码安装

# 克隆项目
git clone https://github.com/hesoyamlp1/MCP-NovelAI.git
cd MCP-NovelAI

# 使用 uv 安装依赖
uv sync

# 运行
NOVELAI_API_KEY=pst-xxx uv run novelai-mcp

运行选项

# Stdio 模式（默认，Claude Desktop / Antigravity / Cursor）
NOVELAI_API_KEY=pst-xxx novelai-mcp

# HTTP 模式（LobeChat / Dify）
NOVELAI_API_KEY=pst-xxx novelai-mcp --transport streamable-http --port 3000

# 或者使用 .env 文件
cp .env.example .env
# 编辑 .env 填入你的 API Key
novelai-mcp

调试

# 使用 MCP Inspector
uvx mcp dev src/novelai_mcp/server.py

🔧 接入配置

Claude Desktop / Antigravity / Cursor

通过 PyPI（推荐）：

{
  "mcpServers": {
    "novelai": {
      "command": "uvx",
      "args": ["novelai-mcp"],
      "env": {
        "NOVELAI_API_KEY": "pst-xxx"
      }
    }
  }
}

从源码：

{
  "mcpServers": {
    "novelai": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/MCP-NovelAI", "novelai-mcp"],
      "env": {
        "NOVELAI_API_KEY": "pst-xxx"
      }
    }
  }
}

LobeChat / Dify

启动 HTTP 模式后，在客户端配置：

  • URL: http://localhost:3000/mcp
  • 传输: Streamable HTTP

🌍 环境变量

变量 必需 说明
NOVELAI_API_KEY ✅ NovelAI API Key
NOVELAI_SAVE_DIR ❌ 图片自动保存目录
HTTPS_PROXY ❌ HTTPS 代理地址

📄 许可证

MIT

相关 MCP