連接方式

連接方式

KPainter MCP 支持本地 stdio 和遠程 Streamable HTTP。

工作室

適合桌面端 MCP 客戶端、IDE 和本地 Agent：

kp-mcp --stdio

從源碼運行：

python -m src.mcp_server --stdio

優點：

• 配置簡單。
• API Key 可以放在本地環境變量。
• 調試時容易查看進程是否正常。

可播放的HTTP

適合託管 Agent 平臺或遠程 MCP 客戶端。正式服務路徑為：

https://api.kpainter.ai/mcp

本地獨立運行：

uvicorn src.mcp_server:app --reload --port 8002

默認本地地址：

http://127.0.0.1:8002/mcp

Streamable HTTP 客戶端應遵循標準 MCP 會話流程，並保留響應中的 Mcp-Session-Id。

如何選擇

• 本地桌面或 IDE：優先 stdio。
• 託管 Agent 或遠程服務：使用 Streamable HTTP。
• 普通網站或移動應用：通常直接使用 KPainter OpenAPI 更簡單。

無論選擇哪一種，八個工具及其字段保持一致。