连接方式

连接方式

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

stdio

适合桌面端 MCP 客户端、IDE 和本地 Agent：

kp-mcp --stdio

从源码运行：

python -m src.mcp_server --stdio

优点：

• 配置简单。
• API Key 可以放在本地环境变量。
• 调试时容易查看进程是否正常。

Streamable 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 更简单。

无论选择哪一种，八个工具及其字段保持一致。