Karin MCP bridge plugin (stdio MCP server + /MCP HTTP bridge)
npm install karin-plugin-mcp让 LLM/IDE 通过 MCP(stdio)调用 Karin:mcp-server(stdio) → HTTP Bridge(/MCP)→ Mock Adapter(注入消息/聚合回包/截图渲染)。
bash
pnpm add karin-plugin-mcp -w
` 使用 #mcp导出配置 命令 ,获取填入IDE的json配置 e.g:
`json
{
"mcpServers": {
"karin-mcp": {
"command": "node",
"args": [
"G:\\BotDev\\karin\\karin-plugin-mcp\\lib\\mcp-server.js",
"--karin-url",
"http://127.0.0.1:7777/MCP",
"--log-level",
"error",
"--no-config-read"
]
}
}
}
`
!alt text
默认 HTTP Bridge 挂载路径:
/MCP安全说明
本插件默认不做 Key 鉴权(预期仅本机/内网使用)。如需限制访问,请在 Web UI 配置
security.ipAllowlist(IP/CIDR 白名单),并确保包含本机 127.0.0.1 / ::1。HTTP Bridge
- GET /MCP/health
- GET /MCP/files/:filename(渲染产物)
- POST /MCP/api/bot.status
- POST /MCP/api/meta.actions
- POST /MCP/api/mock.incoming.message
- POST /MCP/api/mock.status
- POST /MCP/api/mock.history
- POST /MCP/api/render.screenshot
- POST /MCP/api/config.get(可选:需 Web UI 开启 mcpTools.configRead)
- POST /MCP/api/test.*(JSON 测试记录与场景测试,详见 docs/API.md)JSON 测试记录
插件会把测试调用记录落盘到:
- @karinjs/(HTTP 请求/响应摘要)
- @karinjs/