传输方式

MCP 服务器支持两种传输方式。请按你打算如何使用它来选择。

传输方式

使用场景

成本

并发

stdio

本地智能体集成(Claude Desktop、Cline)

最低 —— 没有网络开销

单客户端

streamable-http

远程 / 多客户端 / 生产部署

略高(HTTP 分帧)

多客户端

快速选择指南

        graph TD
    Q{How will you use the server?}
    Q -->|Local agent on the same machine| A[stdio]
    Q -->|Remote / multi-client / production| B[streamable-http]
    Q -->|Scripting — direct CLI use| C[CLI: novelai-image-mcp generate<br/>uv run python -m ...]
    Q -->|Portable agent instructions| D[Agent skills<br/>npx skills add …]
    

技能不是传输方式 —— 它们是 skills.sh 包,用来教 AI 智能体 如何使用 CLI 或 MCP 工具。当你希望自己的编码智能体(Claude Code、Codex、 Copilot……)无需人工提示就了解本项目的命令与参数时,就安装它们。详见 Agent 技能。

与传输方式无关的设计

服务器的 lifespan 持有一个共享的 httpx.AsyncClient(连接池)和一个 NovelAIClient。每个工具都从请求上下文的 lifespan 状态中读取它们 —— 工具代码与工具签名都不随传输方式变化。

传输方式在服务器启动时通过 MCP_TRANSPORT(或 CLI 的 --transport 标志) 选定:

# stdio (default)
MCP_TRANSPORT=stdio uv run python -m novelai_image_mcp serve

# streamable-http
MCP_TRANSPORT=streamable-http uv run python -m novelai_image_mcp serve

MCP_* 变量的完整清单见 配置。