Skip to main content
Glama
2332239652

NovelAI_MCP

by 2332239652
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

NovelAI MCP Server

📌 本仓库基于 SGSxingchen/NovelAI_MCP 二次开发，保留了原作者的完整提交历史，感谢原作者的贡献。

💡 搭配推荐：配合 novelai-assistant（面向 AI Agent 的 NovelAI 提示词工程 Skill）使用，AI 可自动将自然语言描述转换为 Danbooru 风格提示词，再交给本 MCP Server 生成图片。

License: MIT TypeScript Node MCP

一个功能完整的 Model Context Protocol (MCP) 服务器，为 NovelAI 图像生成 API 提供支持

English | 简体中文

✨ 特性

  • 🎨 最新模型支持 - 支持 NAI Diffusion V5 Full / V5 Curated，并保留 V4.5 Full / V4.5 Curated

  • 🚀 双传输模式 - Stdio、HTTP SSE、Streamable HTTP

  • 🎭 多角色支持 - V4+ 角色定位和独立提示词系统

  • 📝 中文优化 - 工具描述使用中文，AI 更准确识别调用时机

  • 🔧 灵活部署 - 支持本地运行或 Docker 容器化

Related MCP server: MCP Image Generator

📦 快速开始

安装

# 克隆项目
git clone https://github.com/2332239652/NovelAI_MCP.git
cd NovelAI_MCP

# 安装依赖
npm install

# 编译
npm run build

配置

方式一：Stdio 模式（Claude Desktop）

在 Claude Desktop 配置文件中添加：

{
  "mcpServers": {
    "novelai": {
      "command": "node",
      "args": ["项目路径/dist/index.js"],
      "env": {
        "NOVELAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

方式二：Streamable HTTP 模式（LobeChat/Dify 推荐）

Linux/Mac:

export NOVELAI_API_KEY="your-api-key"
export HTTPS_PROXY="http://127.0.0.1:7890"  # 可选：设置代理
npm run start:http

Windows PowerShell:

$env:NOVELAI_API_KEY="your-api-key"
$env:HTTPS_PROXY="http://127.0.0.1:7890"  # 可选：设置代理
npm run start:http

Windows CMD:

set NOVELAI_API_KEY=your-api-key
set HTTPS_PROXY=http://127.0.0.1:7890
npm run start:http

在客户端配置中添加：

  • URL: http://localhost:3000/mcp

  • 传输: Streamable HTTP

方式三：SSE 模式（备选）

Linux/Mac:

export NOVELAI_API_KEY="your-api-key"
export HTTPS_PROXY="http://127.0.0.1:7890"  # 可选
npm run start:sse

Windows PowerShell:

$env:NOVELAI_API_KEY="your-api-key"
$env:HTTPS_PROXY="http://127.0.0.1:7890"
npm run start:sse

Windows CMD:

set NOVELAI_API_KEY=your-api-key
set HTTPS_PROXY=http://127.0.0.1:7890
npm run start:sse

在客户端配置中添加：

  • URL: http://localhost:3000/sse

  • 传输: Server-Sent Events (SSE)

🎯 支持的模型

当前默认使用最新的 NovelAI V5 Full，同时支持 V5 Curated 与 V4.5：

模型

说明

nai-diffusion-5-full

NAI Diffusion V5 Full（默认，最新最强）

nai-diffusion-5-curated

NAI Diffusion V5 Curated（精选模型）

nai-diffusion-5-full-inpainting

V5 Full 局部重绘模型

nai-diffusion-5-curated-inpainting

V5 Curated 局部重绘模型

nai-diffusion-4-5-full

NAI Diffusion V4.5 Full

nai-diffusion-4-5-curated

NAI Diffusion V4.5 Curated

🔧 核心参数

参数

类型

说明

model

string

模型 ID，默认 nai-diffusion-5-full，可选 nai-diffusion-5-curated、nai-diffusion-4-5-full 等

base_prompt

string

全局场景和风格描述

base_negative_prompt

string

全局负面提示词

characters

array

角色数组（V5 最多 32 个，V4.5 最多 6 个）

width / height

number

图片尺寸（必须是 64 的倍数）

steps

number

采样步数；不填时 V5 默认 23，V4.5 默认 28

完整参数列表请查看 快速参考。

📊 传输模式对比

特性

Stdio 模式

Streamable HTTP

SSE 模式

适用场景

Claude Desktop

LobeChat、Dify（推荐）

SSE 客户端

协议标准

MCP Stdio

MCP Streamable HTTP

MCP SSE Transport

端点

-

/mcp

/sse + /message

远程访问

❌

✅

✅

多客户端

❌

✅

✅

代理支持

❌

✅

✅

启动命令

npm run start:stdio

npm run start:http

npm run start:sse

🌍 环境变量

变量

必需

默认值

说明

NOVELAI_API_KEY

✅

-

NovelAI API 密钥

NOVELAI_MODEL

❌

nai-diffusion-5-full

默认模型 ID，调用方未指定 model 时生效

NOVELAI_USE_PROXY

❌

V5 默认 true

true 强制所有生成走镜像代理；false 强制 V5 也走官方直连；不设置时 V5 走代理、V4.5 走官方

NOVELAI_SAVE_DIR

❌

%USERPROFILE%\Desktop\NovelAI_Output

图片保存目录，不设置时使用该默认目录

PORT

❌

3000

HTTP 服务器端口（仅 HTTP 模式）

HTTPS_PROXY

❌

-

HTTPS 代理地址

HTTP_PROXY

❌

-

HTTP 代理地址

📚 文档

🛠️ 开发

# 克隆仓库
git clone https://github.com/2332239652/NovelAI_MCP.git
cd NovelAI_MCP

# 安装依赖
npm install

# 编译
npm run build

# 开发模式
npm run dev

# 启动 HTTP 服务器
npm run start:http

🐳 Docker 部署（可选）

项目包含 Dockerfile，可以自行构建：

# 构建镜像
docker build -t novelai-mcp-server .

# 运行容器
docker run -d \
  -p 3000:3000 \
  -e NOVELAI_API_KEY="your-api-key" \
  --name novelai-mcp \
  novelai-mcp-server

🤝 贡献

欢迎提交 Issue 和 Pull Request！

  1. Fork 本项目

  2. 创建特性分支 (git checkout -b feature/AmazingFeature)

  3. 提交更改 (git commit -m 'Add some AmazingFeature')

  4. 推送到分支 (git push origin feature/AmazingFeature)

  5. 开启 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

🔗 相关链接

如果这个项目对你有帮助，请给个 ⭐️！

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers