Novelai MCP

🚀 NovelAI MCP 服務器

一個功能完整的 Model Context Protocol (MCP) 服務器，為 NovelAI 圖像生成 API 提供支持。它能助力用戶更便捷地使用 NovelAI 的圖像生成功能，提升工作和創作效率。

✨ 主要特性

• 🎨 最新模型支持：完整支持 NAI Diffusion V4.5 Full，可讓用戶體驗到最新模型帶來的優質圖像生成效果。
• 🚀 雙傳輸模式：具備 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

配置方式

方式一：Stdio 模式（Claude Desktop）

在 Claude Desktop 配置文件中添加：

{
  "mcpServers": {
    "novelai": {
      "command": "node",
      "args": ["項目路徑/dist/index.js"],
      "env": {
        "NOVELAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

方式二：Streamable HTTP 模式（LobeChat/Dify 推薦）

Linux/Mac：

export NOVELAI_API_KEY="your-api-key"
export HTTPS_PROXY="http://127.0.0.1:7890"  # 可選：設置代理
npm run start:http

Windows PowerShell：

$env:NOVELAI_API_KEY="your-api-key"
$env:HTTPS_PROXY="http://127.0.0.1:7890"  # 可選：設置代理
npm run start:http

Windows CMD：

set NOVELAI_API_KEY=your-api-key
set HTTPS_PROXY=http://127.0.0.1:7890
npm run start:http

在客戶端配置中添加：

• URL：http://localhost:3000/mcp
• 傳輸：Streamable HTTP

方式三：SSE 模式（備選）

Linux/Mac：

export NOVELAI_API_KEY="your-api-key"
export HTTPS_PROXY="http://127.0.0.1:7890"  # 可選
npm run start:sse

Windows PowerShell：

$env:NOVELAI_API_KEY="your-api-key"
$env:HTTPS_PROXY="http://127.0.0.1:7890"
npm run start:sse

Windows CMD：

set NOVELAI_API_KEY=your-api-key
set HTTPS_PROXY=http://127.0.0.1:7890
npm run start:sse

在客戶端配置中添加：

• URL：http://localhost:3000/sse
• 傳輸：Server-Sent Events (SSE)

🎯 支持的模型

當前版本專注於最新的 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="your-api-key" \
  --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 官方文檔
• 問題反饋