MCP 集成

Kabegame 桌面版内置了一个本地 MCP（Model Context Protocol） 服务器，允许支持 MCP 的 AI 助手直接读取你的画廊、画册、下载任务、畅游记录与已安装插件，并完成少量写操作（创建画册、添加图片、重排顺序、重命名图片）。本页介绍这项能力是什么、怎么连、能做什么；完整的 URI 与字段清单请看 MCP 参考。

什么是 MCP

MCP 是一种开放协议，允许 AI 助手通过统一的接口访问外部工具和数据源。Kabegame 扮演 MCP 服务端的角色，AI 助手（Host）则通过协议连入，像查询文件一样查询你本地的图库。

Kabegame 的 MCP 服务

Kabegame 的 MCP 服务默认关闭。需要在「设置 → MCP」中开启；开启后会监听设置中的端口。

项目	值
监听地址	`127.0.0.1:7490`（仅本机回环；`7490` 为默认端口，可在设置中修改）
端点路径	`/mcp`
传输方式	StreamableHTTP
鉴权	无（依赖回环隔离）
平台	Windows / macOS / Linux（Android 不提供）

完整的端点 URL 为 http://127.0.0.1:7490/mcp。

开启时如果端口被占用，MCP 服务会开启失败并保持关闭，设置页会显示提示。应用启动时如果已保存为开启状态但端口被占用，服务不会启动，并会自动将开关置为关闭。

连接 MCP Host

支持 HTTP transport 的 Host

在 Host（如 Cursor）的 MCP 配置里新增一个 HTTP 类型的服务，把端点填为：

http://127.0.0.1:7490/mcp

连通后，让助手调用 list_resources，或直接读 images://gallery/all、albums://all 等 URI，就能浏览你的画廊。

仅支持 stdio 的 Host

部分 Host（如 Claude Desktop）目前只接受 stdio 方式的 MCP 服务。为此 Kabegame 提供了打包好的 .mcpb 桥接安装包，可以一键装入。详见安装 MCP Bundle。

能让 AI 做什么

Kabegame 通过五类 URI scheme 暴露资源，供助手读取：

URI	用途
`images://gallery/...`	浏览画廊图片（画册、日期、媒体类型、壁纸历史、全部）
`images://id_{id}` / `images://id_{id}/metadata`	读取图片基础字段与爬取期元数据（tag、作者、原始 URL 等）
`albums://all` / `albums://id_{id}`	列出画册，或读取单个画册详情
`tasks://all` / `tasks://id_{id}`	查看下载任务
`surf_records://all` / `surf_records://id_{id}`	查看畅游记录
`plugin://`	列出已安装插件、图标、描述模板、文档资源

此外还提供 4 个写操作工具：

创建画册
向画册添加图片
为画册手动排序（单次 ≤ 100 张）
重命名图片

字段、查询参数、分页规则等细节请直接参考 MCP 参考。

分页行为

画廊图片路径使用 images://gallery/.../x{pageSize}x/{page} 表达分页，例如 images://gallery/all/desc/x100x/1。页码从 1 开始，传 0 视为非法。

手动排序的可见性

通过 MCP 工具调整画册内顺序后，需要在 Kabegame 内打开该画册，把排序模式切换到「画册顺序」才能看到手动排序的效果。

安全

MCP 服务绑定在 127.0.0.1，只接受本机进程的连接，因此不设鉴权。

排障

Host 连不上 http://127.0.0.1:7490/mcp → 先确认已在「设置 → MCP」开启服务，并核对 Host 里的端口是否与设置一致。如果端口被其他程序占用，可以在设置里改用其他端口；手动开启时端口冲突会导致开启失败并保持关闭，设置页会提示原因；应用启动时如果检测到端口冲突，则 MCP 服务不启动，并自动将开关置为关闭。
Android 上找不到 MCP → Android 版本不内置 MCP 服务，请改用桌面版作为 MCP 主机。