Novelai MCP

🚀 NovelAI MCP Server

完全な機能を備えた Model Context Protocol (MCP) サーバーで、NovelAI 画像生成 API をサポートします。

🚀 クイックスタート

インストール

# プロジェクトをクローンする
git clone https://github.com/SGSxingchen/NovelAI_MCP.git
cd NovelAI_MCP

# 依存関係をインストールする
npm install

# コンパイルする
npm run build

設定

方法1：Stdio モード（Claude Desktop）

Claude Desktop の設定ファイルに以下を追加します。

{
  "mcpServers": {
    "novelai": {
      "command": "node",
      "args": ["プロジェクトのパス/dist/index.js"],
      "env": {
        "NOVELAI_API_KEY": "あなたのAPIキーをここに入力"
      }
    }
  }
}

方法2：Streamable HTTP モード（LobeChat/Dify 推奨）

Linux/Mac:

export NOVELAI_API_KEY="あなたのAPIキー"
export HTTPS_PROXY="http://127.0.0.1:7890"  # オプション：プロキシを設定する
npm run start:http

Windows PowerShell:

$env:NOVELAI_API_KEY="あなたのAPIキー"
$env:HTTPS_PROXY="http://127.0.0.1:7890"  # オプション：プロキシを設定する
npm run start:http

Windows CMD:

set NOVELAI_API_KEY=あなたのAPIキー
set HTTPS_PROXY=http://127.0.0.1:7890
npm run start:http

クライアント設定に以下を追加します。

• URL: http://localhost:3000/mcp
• 転送: Streamable HTTP

方法3：SSE モード（代替案）

Linux/Mac:

export NOVELAI_API_KEY="あなたのAPIキー"
export HTTPS_PROXY="http://127.0.0.1:7890"  # オプション
npm run start:sse

Windows PowerShell:

$env:NOVELAI_API_KEY="あなたのAPIキー"
$env:HTTPS_PROXY="http://127.0.0.1:7890"
npm run start:sse

Windows CMD:

set NOVELAI_API_KEY=あなたのAPIキー
set HTTPS_PROXY=http://127.0.0.1:7890
npm run start:sse

クライアント設定に以下を追加します。

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

✨ 主な機能

• 🎨 最新モデルのサポート - NAI Diffusion V4.5 Full を完全にサポートします。
• 🚀 2種類の転送モード - Stdio、HTTP SSE、Streamable HTTP
• 🎭 複数のキャラクターサポート - V4+ キャラクターの位置決めと独立したプロンプトシステム
• 📝 中国語最適化 - ツールの説明を中国語で提供し、AI が呼び出しタイミングをより正確に認識できるようにします。
• 🔧 柔軟なデプロイメント - ローカルでの実行または Docker コンテナ化をサポートします。

📦 インストール

# プロジェクトをクローンする
git clone https://github.com/SGSxingchen/NovelAI_MCP.git
cd NovelAI_MCP

# 依存関係をインストールする
npm install

# コンパイルする
npm run build

🎯 サポートされているモデル

現在のバージョンは最新の NovelAI V4.5 モデルに焦点を当てています。

🔧 技術詳細

核心パラメータ

転送モードの比較

環境変数

📚 ドキュメント

• 🚀 HTTP クイックスタート
• 📋 クイックリファレンスカード
• 📝 完全な機能の要約
• 📜 更新履歴

🛠️ 開発

# リポジトリをクローンする
git clone https://github.com/SGSxingchen/NovelAI_MCP.git
cd NovelAI_MCP

# 依存関係をインストールする
npm install

# コンパイルする
npm run build

# 開発モード
npm run dev

# HTTP サーバーを起動する
npm run start:http

🐳 Docker デプロイ（オプション）

プロジェクトには Dockerfile が含まれており、独自にビルドすることができます。

# イメージをビルドする
docker build -t novelai-mcp-server .

# コンテナを実行する
docker run -d \
  -p 3000:3000 \
  -e NOVELAI_API_KEY="あなたのAPIキー" \
  --name novelai-mcp \
  novelai-mcp-server

🤝 貢献

Issue や Pull Request の投稿を歓迎します！

1. このプロジェクトを Fork する
2. 機能ブランチを作成する (git checkout -b feature/AmazingFeature)
3. 変更をコミットする (git commit -m 'Add some AmazingFeature')
4. ブランチにプッシュする (git push origin feature/AmazingFeature)
5. Pull Request を作成する

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています - 詳細については LICENSE ファイルを参照してください。

🙏 謝辞

• NovelAI - 強力な画像生成 API を提供してくれました。
• Model Context Protocol - MCP プロトコルの仕様
• Anthropic - MCP SDK と Claude

🔗 関連リンク

• NovelAI 公式サイト
• NovelAI API ドキュメント
• MCP 公式ドキュメント
• 問題の報告