Novelai MCP Server

NovellAI MCP服务器

\[以下为英文自述文件\]

韩语README

使用Model Context Protocol（MCP）服务器创建NovelAI图像。通过角色定位和V4提示等高级功能，可以制作高品质动画。

重要通知

当前API限制：NovelAI API目前 nai-diffusion-3 仅支持模型。高级V4.5功能在Web界面中可用，但在API中尚不受支持。NovelAI扩展API支持后，我们会立即更新！

功能

• 🎨 创建AI图像 使用NovelAI的nai-diffusion-3模型
• 🎭 高级角色定位 以V4提示符格式
• 💾 直接保存文件 直接在桌面上
• 🔧 简单设置 环境变量或.env文件
• 🌐 跨平台 支持（Windows、Linux、MacOS）
• 📦 无需设置 直接安装到npm
• ⚡ 高级参数：动态阈值、多样性提升、质量切换

安装方法（韩语）

全局安装（建议）

npm install -g novelai-mcp-server

本地安装

npm install novelai-mcp-server

设置方法（韩语）

方法1:环境变量（建议）

窗户：

setx NOVELAI_API_KEY "당신의-API-키"

Linux/macOS：

export NOVELAI_API_KEY="당신의-API-키"
echo 'export NOVELAI_API_KEY="당신의-API-키"' >> ~/.bashrc

方法2:.env文件

在运行服务器的目录中 .env 创建文件：

NOVELAI_API_KEY=당신의-API-키

MCP设置（韩语）

添加到MCP客户端设置文件（通常 ~/.config/claude/mcp.json):

{
  "mcpServers": {
    "novelai": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "novelai-mcp-server"]
    }
  }
}

使用示例（韩语）

创建默认映像

아름다운 애니메 소녀 이미지 생성해줘

包括文件保存

애니메 일몰 노을 이미지 생성하고 파일로 저장해줘

角色定位

왼쪽에는 금발 여자아이, 오른쪽에는 검은머리 남자아이가 있는 공원 이미지 생성해줘

______________________________________________________________________

NovellAI MCP服务器

用于NovellAI图像生成的模型上下文协议（MCP）服务器。使用角色定位和V4提示等高级功能创建高质量的动漫艺术。

⚠️ 重要提示

API当前限制：NovelAI的API目前支持 nai-diffusion-3 只有模型。高级V4.5功能在web界面上可用，但尚未在API中提供。我们将在NovelAI扩展API支持后尽快更新！

特性

• 🎨 AI图像生成 使用NovellAI的指甲扩散-3模型
• 🎭 高级角色定位 采用V4提示格式
• 💾 直接文件保存 到您的桌面
• 🔧 轻松设置 使用环境变量或.env文件
• 🌐 跨平台 支持（Windows、Linux、macOS）
• 📦 零配置安装 通过npm
• ⚡ 高级参数：动态阈值、多样性提升、质量切换

安装

全局安装（推荐）

npm install -g novelai-mcp-server

本地安装

npm install novelai-mcp-server

配置

方法1：环境变量（推荐）

窗户：

setx NOVELAI_API_KEY "your-api-key-here"

Linux/macOS：

export NOVELAI_API_KEY="your-api-key-here"
echo 'export NOVELAI_API_KEY="your-api-key-here"' >> ~/.bashrc

方法2:.env文件

创建一个 .env 运行服务器的同一目录中的文件：

NOVELAI_API_KEY=your-api-key-here

方法3:WSL2配置

echo 'export NOVELAI_API_KEY="your-api-key-here"' >> ~/.bashrc
source ~/.bashrc

MCP配置

添加到MCP客户端配置文件（通常 ~/.config/claude/mcp.json 或类似）：

{
  "mcpServers": {
    "novelai": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "novelai-mcp-server"]
    }
  }
}

可用工具

🎨 generate_image

使用NovellAI的指甲扩散-3模型生成高质量的动漫图像。

基本参数：

• prompt （必填）：用于生成图像的文本提示
• model：要使用的模型（默认值：“指甲扩散-3”）⚠️ 目前仅支持型号
• sampler：采样器算法（默认值：“k_euler_ancestral”）
• seed：随机种子（默认值：-1表示随机）
• negative_prompt：负面提示以避免不需要的元素
• n_samples：要生成的图像数量（默认值：1）
• width：图像宽度（默认值：512）
• height：图像高度（默认值：768）
• scale：CFG比例-提示遵守（默认值：5.0）
• steps：生成步骤数（默认值：28）

🎭 高级功能：

• v4_prompt：V4字符定位提示格式

- base_caption：基础场景描述 - char_captions：具有精确x、y坐标（0-1范围）的字符数组

• save_to_file：将图像保存到本地文件（默认值：false）
• output_dir：自定义保存目录（默认：桌面/novalai_images）
• filename：自定义文件名（不带扩展名）
• dynamic_thresholding：启用以获得更好的对比度
• variety_boost：实现更多样化的结果
• quality_toggle：实现质量提升

📱 示例用法：

基础：

Generate an image of a beautiful anime girl in a garden, masterpiece, best quality

角色定位：

{
  "prompt": "masterpiece, anime style, park scene",
  "v4_prompt": {
    "base_caption": "masterpiece, anime style, park scene",
    "char_captions": [
      {
        "centers": [{"x": 0.3, "y": 0.4}],
        "char_caption": "1girl, blonde hair, blue eyes, smiling, summer dress"
      }
    ]
  },
  "save_to_file": true
}

使用文件保存：

Generate image of anime sunset, save to file, use dynamic thresholding

快速入门示例

基本图像生成

1. 问你的人工智能助手：“生成一个漂亮的蓝头发动漫女孩的图像”
2. 助理将使用 generate_image 工具
3. 图像数据将以base64格式返回

字符定位

1. 问：“创建一个左侧有一个女孩，右侧有一个男孩的图像”
2. 助手将使用V4提示符进行字符定位
3. 字符将被放置在精确的坐标处

文件保存

1. 问：“生成动漫景观并将其保存到文件中”
2. 图像将自动保存到桌面/novalai_images/

API密钥设置

1. 访问 诺贝莱
2. 注册或登录您的帐户
3. 转到帐户设置→ API密钥
4. 生成新的API密钥
5. 复制密钥并使用上述配置方法之一进行设置

故障排除

常见问题

“找不到API密钥”

• 确保NOVELAI_API_KEY设置正确
• 检查.env文件是否在正确的目录中
• 验证环境变量是否正确导出

“模型不存在”错误

• 目前仅使用“指甲扩散-3”型号
• NovelAI API还不支持V4.5

图像生成失败

• 检查您的NovellAI账户余额
• 验证API密钥有效且处于活动状态
• 检查互联网连接

文件保存失败

• 确保桌面目录存在
• 检查写入权限
• 验证输出目录路径是否有效

调试模式

为详细日志设置DEBUG环境变量：

DEBUG=novelai-mcp-server:* npx -y novelai-mcp-server

发展

地方发展设置

git clone https://github.com/ginishuh/novelai-mcp-server.git
cd novelai-mcp-server
npm install
npm start

贡献

1. 复刻仓库
2. 创建要素分支
3. 进行更改
4. 提交拉取请求

局限性

• 模型支撑：只有 nai-diffusion-3 目前可通过API获得
• 速率限制：受NovelAI API利率限制
• 账户要求：需要有效的NovellAI订阅

未来更新

我们正在积极监控NovelAI的API更新，并将增加对以下内容的支持：

• API中提供的V4.5型号
• 附加采样器和参数
• 增强的角色定位功能
• 文本生成功能

许可证

请参阅MIT License-LICENSE文件

作者

圭亚那语 -

支持

• 📧 问题：
• 🐛 错误报告： 创建问题

______________________________________________________________________

由...制作❤️ 作者：ginishuh |版本0.1.0

______________________________________________________________________

许可证（英文）

MIT许可证-有关详细信息，请参阅许可证文件

作者（英文）

圭亚那语 -

支持（英语）

• 📧 问题：
• 🐛 Bug报告： 创建问题

______________________________________________________________________

由...制作❤️ 作者：ginishuh |版本0.1.0