xinvxueyuan/NovelAI-Image-MCP

MCP server for integrating NovelAI Image generation into AI agents.

About NovelAI-Image-MCP

An MCP (Model Context Protocol) server that exposes NovelAI image generation as tools for AI agents (Claude Desktop, Cline, custom agents, remote clients).

Built on the official MCP Python SDK v2 (MCPServer), it lets an agent generate images (txt2img / img2img / inpaint), upscale, run Director tools (line art, emotion, background removal, …), annotate with ControlNet, suggest tags, encode vibes, and query account subscription — all through the standard MCP tool interface.

- 11 MCP tools covering the full NovelAI image API surface. - Two transports: stdio (local agents) + streamable-http (remote / multi-client). - Dual image return: base64 Image content blocks (the agent sees the image) and PNG saved to disk (path returned as text). - Async + sync: async tool handlers + a typer CLI for direct invocation. - Monorepo: uv workspace (Python) + pnpm workspace (Node tooling) orchestrated by Turbo; MIT-licensed, Docker-ready, GitHub Pages docs.

See CONTRIBUTING.md for the developer guide and apps/docs/source/ for the full documentation source.

If you plan to contribute, install the cross-cutting Node toolchain (turbo, husky, markdownlint) via pnpm:

This wires the husky pre-commit + commit-msg hooks and gives you turbo / markdownlint-cli2 for local development. The MCP server has zero Node runtime dependencies — this step is only for contributors.

The MCP server supports two transports (stdio + http), all configured under mcpServers:

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/xinvxueyuan--NovelAI-Image-MCP.html)

Related MCP servers