NovelAI Image MCP¶
MCP (Model Context Protocol) サーバーであり、NovelAI 画像生成を AI エージェント向けツールとして公開するものです — Claude Desktop、Cline、 自作エージェント、リモートクライアントなどで利用できます。
FastMCP 4(MCP SDK v2 mcp>=2.3.0 上の fastmcp フレームワーク)上に構築され、
エージェントは標準の MCP ツールインターフェースを通じて、画像生成(txt2img / img2img /
inpaint)、アップスケール、Director ツールの実行(ラインアート、エモーション、
背景除去など)、ControlNet によるアノテーション、タグ補完、vibe のエンコード、
アカウントサブスクリプションの照会を行えます。
主な特徴¶
11 個の MCP ツール — NovelAI 画像 API の全機能を網羅。
2 種類のトランスポート — stdio(ローカルエージェント向け)と streamable-http(リモート / マルチクライアント向け)。
デュアルな戻り値 — base64 の
Imageコンテンツブロック(エージェントが画像を 認識 できる)と ディスクに保存された PNG(パスはテキストで返却)。非同期 + 同期 — 非同期ツールハンドラーと、直接呼び出し向けの
typerCLI。エージェントスキル — AI エージェントに CLI と MCP ツールの使い方を教える 3 つの skills.sh パッケージ(
novelai-cli、novelai-mcp-tools、novelai-workflows)。uv 管理のモノレポ — MIT ライセンス、Docker 対応、GitHub Pages でドキュメントを提供。
はじめに¶
クイックリンク¶
クイックスタート — インストール、設定、最初の 1 枚を生成するまで
ツールリファレンス — すべての MCP ツール、パラメータ、例
トランスポート — stdio と streamable-http
エージェントホストの設定 — Claude Desktop、Cline、Cursor、Continue、Windsurf、Codex CLI
API リファレンス — autodoc 生成の Python API
コントリビュート — サーバーを改造するには
プロジェクトリンク¶
Issue: https://github.com/xinvxueyuan/NovelAI-Image-MCP/issues
ライセンス: MIT
変更履歴: Keep a Changelog
NovelAI API ドキュメント: https://image.novelai.net/docs/index.html