Novelai MCP

🚀 NovelAI MCP 服务器

一个功能完整的 Model Context Protocol (MCP) 服务器，为 NovelAI 图像生成 API 提供支持。它能助力用户更便捷地使用 NovelAI 的图像生成功能，提升工作和创作效率。

✨ 主要特性

• 🎨 最新模型支持：完整支持 NAI Diffusion V4.5 Full，可让用户体验到最新模型带来的优质图像生成效果。
• 🚀 双传输模式：具备 Stdio、HTTP SSE、Streamable HTTP 三种传输模式，满足不同场景下的数据传输需求。
• 🎭 多角色支持：拥有 V4+ 角色定位和独立提示词系统，方便用户在图像生成中设置不同角色。
• 📝 中文优化：工具描述使用中文，使 AI 更准确识别调用时机，提升使用体验。
• 🔧 灵活部署：支持本地运行或 Docker 容器化，方便不同环境下的部署和使用。

📦 安装指南

安装步骤

# 克隆项目
git clone https://github.com/SGSxingchen/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 V4.5 模型：

🔧 技术细节

核心参数

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

传输模式对比

环境变量

📚 详细文档

• 🚀 HTTP 快速开始
• 📋 快速参考卡片
• 📝 完整功能总结
• 📜 更新日志

🛠️ 开发

# 克隆仓库
git clone https://github.com/SGSxingchen/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 文件了解详情。

🙏 致谢

• NovelAI - 提供强大的图像生成 API
• Model Context Protocol - MCP 协议规范
• Anthropic - MCP SDK 和 Claude

🔗 相关链接

• NovelAI 官网
• NovelAI API 文档
• MCP 官方文档
• 问题反馈