NovelAI Image MCP

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(パスはテキストで返却)。

  • 非同期 + 同期 — 非同期ツールハンドラーと、直接呼び出し向けの typer CLI。

  • エージェントスキル — AI エージェントに CLI と MCP ツールの使い方を教える 3 つの skills.sh パッケージ(novelai-cli、novelai-mcp-tools、novelai-workflows)。

  • uv 管理のモノレポ — MIT ライセンス、Docker 対応、GitHub Pages でドキュメントを提供。


はじめに


クイックリンク


プロジェクトリンク