用途:在已建立 QMD 索引的本地环境中,通过 uxc 的固定 MCP stdio 链路查询本地知识库,适合已有 QMD 索引的笔记、Markdown 语料与本地知识库检索。
前提:uxc 与 qmd 均已安装并可在 PATH 中调用,且 QMD 索引已存在且健康,可先用 qmd status、qmd update、qmd embed 检查。使用 GPU 时需在 qmd mcp 所用 shell 中导出 CUDA_PATH、CUDACXX、LD_LIBRARY_PATH 或 Node/nvm 等运行时环境。
主要能力:query 搜索(lex、vec、hyde 类型)、get 与 multi_get 检索、status 健康检查。
使用方式:先用 command -v qmd-mcp-cli 检查固定命令是否可用;缺失时执行 uxc link --daemon-idle-ttl 0 qmd-mcp-cli "qmd mcp" 建立链路;若依赖 nvm、CUDA 等 shell 环境,则用显式包装命令。随后可通过 uxc daemon status 与 uxc daemon sessions 确认守护进程会话,并用 qmd-mcp-cli <operation> -h 查看操作 schema。建议先以显式 lex/vec/hyde 执行 query,缩小候选后再用 get 或 multi_get。
限制与注意事项:首个 MCP 请求可能较慢,会话预热后延迟可明显下降。自动化解析应以 JSON 输出信封为准,优先读取 ok、kind、protocol、data、error 等稳定字段,不要依赖 --text。lex 为默认快速路径,vec 用于有界语义查询,hyde 最昂贵;保持 limit 与 candidateLimit 适中。若发生命令冲突且无法安全复用,应停止并请维护者更换固定命令名。官方资料未提供功能以外的收费、价格或效果说明。