Is io.github.xinvxueyuan/novelai-image-mcp safe to use?

io.github.xinvxueyuan/novelai-image-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.

How do I install io.github.xinvxueyuan/novelai-image-mcp?

io.github.xinvxueyuan/novelai-image-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.

What can io.github.xinvxueyuan/novelai-image-mcp do?

io.github.xinvxueyuan/novelai-image-mcp provides 12 tools: Documentation, Monorepo, mcpServers, main, Source and 7 more. See the full tools list on the server page for descriptions and parameters.

What AI clients work with io.github.xinvxueyuan/novelai-image-mcp?

io.github.xinvxueyuan/novelai-image-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.

Is io.github.xinvxueyuan/novelai-image-mcp actively maintained?

io.github.xinvxueyuan/novelai-image-mcp is actively maintained — last commit was 5 days ago. It has 5 GitHub stars.

io.github.xinvxueyuan/novelai-image-mcp

novelai-image-mcp

NovelAI image generation as MCP tools: txt2img, img2img, inpaint, upscale, Director, ControlNet.

5 12 tools GitHub PyPI

No known CVEs

MIT license

Actively maintained

Last commit 5d ago

Works with most clients

Transport: stdio, http

12 tools · ~373 tok

Grade A · 0.2% of 200K ctx

MCPpedia last refreshed this data 8h ago

Edit this pageView history

io.github.xinvxueyuan/novelai-image-mcp is an MCP server that NovelAI image generation as MCP tools: txt2img, img2img, inpaint, upscale, Director, ControlNet. Its tool list has not been published yet over stdio and http, requires no API key, and scores 87/100 on MCPpedia's security, maintenance and efficiency rubric.

AI / ML

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "novelai-image": {
      "env": {
        "NOVELAI_TOKEN": "${input:novelai_token}"
      },
      "args": [
        "run",
        "--directory",
        "/path/to/NovelAI-Image-MCP",
        "python",
        "-m",
        "novelai_image_mcp",
        "serve"
      ],
      "type": "stdio",
      "command": "uv"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-xinvxueyuan-novelai-image-mcp)](https://mcppedia.org/s/io-github-xinvxueyuan-novelai-image-mcp)

Read me

What io.github.xinvxueyuan/novelai-image-mcp does

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

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'novelai-image-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

87/100across 5 weighted dimensions

How we score →

0255075100

−13

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked novelai-image-mcp against OSV.dev.

Inventory

Tools (12)

Click any tool to inspect its schema.

~373 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.xinvxueyuan/novelai-image-mcp safe to use?: io.github.xinvxueyuan/novelai-image-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install io.github.xinvxueyuan/novelai-image-mcp?: io.github.xinvxueyuan/novelai-image-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.xinvxueyuan/novelai-image-mcp do?: io.github.xinvxueyuan/novelai-image-mcp provides 12 tools: Documentation, Monorepo, mcpServers, main, Source and 7 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.xinvxueyuan/novelai-image-mcp?: io.github.xinvxueyuan/novelai-image-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.
Is io.github.xinvxueyuan/novelai-image-mcp actively maintained?: io.github.xinvxueyuan/novelai-image-mcp is actively maintained — last commit was 5 days ago. It has 5 GitHub stars.

Similar servers

Others in ai-ml

View all →

Dsh MCP Client97

MCP client bridge: connects to MCP servers and registers their tools on ctx.tools

186.4k 4

Modelcontextprotocol96

The official MCP server implementation for the Perplexity API Platform

2.5k 4

Antigravity Workspace Template96

Workspace template + MCP server for Claude Code, Codex CLI, Cursor & Windsurf. Multi-agent knowledge engine (ag-refresh / ag-ask) that turns any codebase into a queryable AI assistant.

1.3k 2

Claude Flow95

Ruflo - Enterprise AI agent orchestration for Claude Code. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration

68.9k 4

MCP Security Weekly

Get CVE alerts and security updates for io.github.xinvxueyuan/novelai-image-mcp and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?

Edit this pageView history

AI / ML

Step 1

Install in your client

Config is the same across clients — only the file and path differ.

Supported in Claude Desktopstdio, http · Node 18+

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "novelai-image": {
      "env": {
        "NOVELAI_TOKEN": "${input:novelai_token}"
      },
      "args": [
        "run",
        "--directory",
        "/path/to/NovelAI-Image-MCP",
        "python",
        "-m",
        "novelai_image_mcp",
        "serve"
      ],
      "type": "stdio",
      "command": "uv"
    }
  }
}

Are you the author?

Add this badge to your README to show your security score and help users find safe servers.

Embed in your READMEAbout badges →

[![MCPpedia Score](https://mcppedia.org/api/badge/io-github-xinvxueyuan-novelai-image-mcp)](https://mcppedia.org/s/io-github-xinvxueyuan-novelai-image-mcp)

Read me

What io.github.xinvxueyuan/novelai-image-mcp does

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

Test This Server

Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.

uvx 'novelai-image-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"

After testing, let us know if it worked:

README

NovelAI Image MCP

[![CI][ci-badge]][ci-workflow] [![Docs][docs-badge]][docs] [![License: MIT][mit-badge]][license] [![Python 3.13+][python-badge]][python] [![uv][uv-badge]][uv] [![REUSE status][reuse-badge]][reuse] [![DeepWiki][deepwiki-badge]][deepwiki] [![skills.sh][skills-badge]][skills-sh]

[![NovelAI Image MCP - MCP server for integrating NovelAI Image generation into AI | Product Hunt][product-hunt-badge]][product-hunt] [![Featured on Lifto][lifto-badge]][lifto]

An [MCP (Model Context Protocol)][mcp] 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.

📖 Documentation: [xinvxueyuan.github.io/NovelAI-Image-MCP][docs]

Features

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.

Repository layout

This is a uv + pnpm monorepo:

NovelAI-Image-MCP/
├── apps/
│   ├── server/                 # MCP server (the installable PyPI package)
│   │   ├── src/novelai_image_mcp/   # 11 MCP tools + NovelAI HTTP client
│   │   ├── tests/
│   │   ├── docker/              # smoke-test entrypoint
│   │   ├── Dockerfile           # built with repo root as context
│   │   └── pyproject.toml       # ruff / pyright / pytest config
│   └── docs/                    # Sphinx documentation site
│       ├── source/              # MyST Markdown + conf.py
│       ├── Makefile
│       └── pyproject.toml
├── .github/                     # workflows, CODEOWNERS, issue templates
├── pyproject.toml               # uv workspace root (virtual)
├── uv.lock                      # single shared lockfile
├── pnpm-workspace.yaml          # pnpm workspace declaration
├── pnpm-lock.yaml               # Node toolchain lockfile
├── turbo.json                   # cross-workspace task graph
├── package.json                 # root scripts + dev toolchain
└── docker-compose.yml           # local container orchestration

See [CONTRIBUTING.md][contributing] for the developer guide and [apps/docs/source/][docs-source] for the full documentation source.

Quick start

Install from source (development)

# 1. Clone
git clone https://github.com/xinvxueyuan/NovelAI-Image-MCP.git
cd NovelAI-Image-MCP

# 2. Sync the uv workspace (installs server + docs + dev tools)
uv sync

# 3. Configure credentials
cp .env.example .env
#   set NOVELAI_TOKEN=...  (preferred)
#   or  NOVELAI_USERNAME + NOVELAI_PASSWORD

# 4. Run (stdio — for local agents)
uv run python -m novelai_image_mcp serve

# 5. Or over HTTP
MCP_TRANSPORT=streamable-http uv run python -m novelai_image_mcp serve
#   → http://127.0.0.1:8000/mcp

Install from PyPI (runtime only)

pip install novelai-image-mcp
export NOVELAI_TOKEN=pst-...
novelai-image-mcp serve

Optional: Node tooling (contributors)

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

corepack enable pnpm      # one-time
pnpm install --frozen-lockfile

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.

Connect an agent

... View full README on GitHub

Loading README…

Scored, not listed

Why this score

Five weighted categories — click any category to see the underlying evidence.

Score breakdown

87/100across 5 weighted dimensions

How we score →

0255075100

−13

Security

Maintenance

Efficiency

Documentation

Compatibility

Categoriesclick a row to see evidence

Security

OSV.dev

No known CVEs.

Checked novelai-image-mcp against OSV.dev.

Inventory

Tools (12)

Click any tool to inspect its schema.

~373 tokens total

Community

Reviews

Be the first to review

Have you used this server?

Share your experience — it helps other developers decide.

How easy was setup?Did it work reliably?How was the documentation?

Frequently Asked Questions

Is io.github.xinvxueyuan/novelai-image-mcp safe to use?: io.github.xinvxueyuan/novelai-image-mcp has no known CVEs as of the latest MCPpedia security scan. It does not require authentication, so any local process can connect — keep this in mind in shared environments. Licensed under MIT.
How do I install io.github.xinvxueyuan/novelai-image-mcp?: io.github.xinvxueyuan/novelai-image-mcp supports copy-paste install configs on its MCPpedia page for Claude Desktop, Cursor, and Claude Code. Scroll to the Quick Install section and select your client.
What can io.github.xinvxueyuan/novelai-image-mcp do?: io.github.xinvxueyuan/novelai-image-mcp provides 12 tools: Documentation, Monorepo, mcpServers, main, Source and 7 more. See the full tools list on the server page for descriptions and parameters.
What AI clients work with io.github.xinvxueyuan/novelai-image-mcp?: io.github.xinvxueyuan/novelai-image-mcp is compatible with claude-desktop, cursor, claude-code. It uses stdio and http transport.
Is io.github.xinvxueyuan/novelai-image-mcp actively maintained?: io.github.xinvxueyuan/novelai-image-mcp is actively maintained — last commit was 5 days ago. It has 5 GitHub stars.

Similar servers

Others in ai-ml

View all →

Dsh MCP Client97

MCP client bridge: connects to MCP servers and registers their tools on ctx.tools

186.4k 4

Modelcontextprotocol96

The official MCP server implementation for the Perplexity API Platform

2.5k 4

Antigravity Workspace Template96

Workspace template + MCP server for Claude Code, Codex CLI, Cursor & Windsurf. Multi-agent knowledge engine (ag-refresh / ag-ask) that turns any codebase into a queryable AI assistant.

1.3k 2

Claude Flow95

Ruflo - Enterprise AI agent orchestration for Claude Code. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration

68.9k 4

MCP Security Weekly

Get CVE alerts and security updates for io.github.xinvxueyuan/novelai-image-mcp and similar servers.

Community

Discussion

Start a conversation

Ask a question, share a tip, or report an issue.

Has anyone used this with Cursor?How do you handle auth?Any alternatives?