MUXUNO / MCP

让 AI 连接你的媒体库

查找媒体、整理合集，直接告诉你常用的 AI。Muxuno 运行时提供本机 MCP 服务，完成一次配置后即可使用。

需要 Windows 版 Muxuno 0.2.29 或更新版本，并在设置 → AI 连接中看到「本地 MCP 已开启」。下载最新版

快速开始

打开 Muxuno
完成登录，确认能看到你要连接的媒体库，并保持应用运行。
复制提示词，发送给本机 AI 客户端
AI 按文档读取本机配置并添加连接。提示词不包含访问令牌。
请阅读 https://muxuno.com/docs/ai/guide.md，帮我把当前 AI 客户端接入这台电脑上正在运行的 Muxuno：只读取本机用户目录 .muxuno/mcp/installed.json 中的连接配置，不输出令牌，替换旧 muxuno 连接并保留其他服务；使用 MCP 自带说明，最后只读验证媒体库。
重新加载 MCP，验证媒体库
按客户端提示重连或新开会话，然后让 AI 查看媒体库和合集数量。

自动配置需要 AI 具备本地文件读取和配置修改能力。没有这些能力时，按下方参考手动配置；一句提示词不能绕过客户端的权限或兼容性限制。

需要支持 Streamable HTTP 和 Authorization 请求头。纯云端连接器不能直接访问你电脑的 127.0.0.1。不同客户端版本与组织策略可能影响可用性。

查看我的 Muxuno 媒体库和合集数量，列出几条媒体名称，先不要修改。

AI 应读取当前账号的真实媒体条目和合集。仅出现工具名称、配置保存成功或端口连通，都不代表接入完成；空库可以返回零条。

连接成功后可以说「找出我的钢琴音乐」或「给这些素材提出分类建议，先预览」。

Skill 可选，连接不依赖它。MCP 已包含工具说明和操作规则。需要更完整的整理指南时，在 Muxuno 设置中复制包含本机 Skill 路径的提示词，交给支持 Skill 的客户端。

Skill 不会自动启动任务，也不保证 AI 每次主动调用。AI 按你的任务使用工具，修改前预览，执行后回读；永久删除媒体需要明确授权。

服务只监听本机，凭据只保存在本机。查询得到的媒体名称等信息仍可能进入你选择的 AI 服务上下文；本机连接不代表模型离线运行。

无法连接或连接被拒绝

确认应用仍在运行且已登录，设置中显示服务已开启。完全退出会关闭服务，最小化不会。遇到端口冲突，关闭另一份占用该端口的应用后重试。

401：令牌不匹配

让 AI 重新读取本机 .muxuno/mcp/installed.json，更新 Authorization 请求头并重连。不要把令牌发送给网站或贴进聊天。

404：切换账号后或闲置后失效

会话闲置 30 分钟或账号变化后需要重新初始化。重新连接并核对当前媒体库，旧整理计划不能继续执行。

配置了但 AI 看不到工具

重新加载客户端 MCP 或新建会话，检查项目级同名配置是否覆盖了用户级配置。确认客户端支持 HTTP 和认证头；不再使用旧启动命令或桥接连接器。

AI 不能替我修改客户端配置

打开下方 AI 可读文档，按当前客户端的示例手动添加 HTTP 服务。AI 不能读取本机文件时，提示词本身无法完成自动接入。