Novelai MCP

🚀 NovelAI MCP Server

A fully functional Model Context Protocol (MCP) server supporting the NovelAI image generation API

✨ Features

• 🎨 Latest Model Support - Fully supports NAI Diffusion V4.5 Full.
• 🚀 Dual Transmission Modes - Stdio, HTTP SSE, and Streamable HTTP.
• 🎭 Multi-Character Support - V4+ character positioning and an independent prompt system.
• 📝 Chinese Optimization - Tool descriptions are in Chinese, enabling AI to more accurately recognize the invocation timing.
• 🔧 Flexible Deployment - Supports local operation or Docker containerization.

🚀 Quick Start

Installation

# Clone the project
git clone https://github.com/SGSxingchen/NovelAI_MCP.git
cd NovelAI_MCP

# Install dependencies
npm install

# Compile
npm run build

Configuration

Method 1: Stdio Mode (Claude Desktop)

Add the following to the Claude Desktop configuration file:

{
  "mcpServers": {
    "novelai": {
      "command": "node",
      "args": ["path-to-project/dist/index.js"],
      "env": {
        "NOVELAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Method 2: Streamable HTTP Mode (Recommended for LobeChat/Dify)

Linux/Mac:

export NOVELAI_API_KEY="your-api-key"
export HTTPS_PROXY="http://127.0.0.1:7890"  # Optional: Set proxy
npm run start:http

Windows PowerShell:

$env:NOVELAI_API_KEY="your-api-key"
$env:HTTPS_PROXY="http://127.0.0.1:7890"  # Optional: Set proxy
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

Add the following to the client configuration:

• URL: http://localhost:3000/mcp
• Transport: Streamable HTTP

Method 3: SSE Mode (Alternative)

Linux/Mac:

export NOVELAI_API_KEY="your-api-key"
export HTTPS_PROXY="http://127.0.0.1:7890"  # Optional
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

Add the following to the client configuration:

• URL: http://localhost:3000/sse
• Transport: Server-Sent Events (SSE)

🎯 Supported Models

The current version focuses on the latest NovelAI V4.5 model:

🔧 Core Parameters

For the full parameter list, please refer to Quick Reference.

📊 Comparison of Transmission Modes

🌍 Environment Variables

📚 Documentation

• 🚀 HTTP Quick Start
• 📋 Quick Reference Card
• 📝 Complete Feature Summary
• 📜 Changelog

🛠️ Development

# Clone the repository
git clone https://github.com/SGSxingchen/NovelAI_MCP.git
cd NovelAI_MCP

# Install dependencies
npm install

# Compile
npm run build

# Development mode
npm run dev

# Start the HTTP server
npm run start:http

🐳 Docker Deployment (Optional)

The project includes a Dockerfile and can be built by yourself:

# Build the image
docker build -t novelai-mcp-server .

# Run the container
docker run -d \
  -p 3000:3000 \
  -e NOVELAI_API_KEY="your-api-key" \
  --name novelai-mcp \
  novelai-mcp-server

🤝 Contribution

Welcome to submit Issues and Pull Requests!

1. Fork this project.
2. Create a feature branch (git checkout -b feature/AmazingFeature).
3. Commit your changes (git commit -m 'Add some AmazingFeature').
4. Push to the branch (git push origin feature/AmazingFeature).
5. Open a Pull Request.

📄 License

This project is licensed under the MIT license - see the LICENSE file for details.

🙏 Acknowledgments

• NovelAI - Provides a powerful image generation API.
• Model Context Protocol - MCP protocol specification.
• Anthropic - MCP SDK and Claude.

🔗 Related Links

• NovelAI Official Website
• NovelAI API Documentation
• MCP Official Documentation
• Issue Feedback