CLI 与 MCP

工作方式

luckyray-cli.exe 与 luckyray-mcp.exe 是正在运行的 LuckyRay 桌面进程的客户端。它们不会直接打开 Vault、SQLite 数据库或应用数据目录。

调用桌面业务工具需要 LuckyRay 正在运行。生成配置等本地辅助命令不代表已经连接；配置时无需复制凭据、端口或应用数据路径。

生成 MCP 配置

LuckyRay 不会自动修改 Codex、Cursor、Claude 或其他 MCP 宿主配置，也不会自动把程序加入 PATH。使用安装目录中的程序生成配置片段，再由用户复制到选择的宿主。

& "C:\Program Files\LuckyRay\luckyray-mcp.exe" --print-config codex

CLI 示例

CLI 输出 JSON。请在 MCP 宿主中设置工具审批，写入前核对目标和范围；工具的只读注解不能代替宿主授权设置。

& "C:\Program Files\LuckyRay\luckyray-cli.exe" tools list
& "C:\Program Files\LuckyRay\luckyray-cli.exe" tools run knowledge.search --input '{"query":"project"}'

先用只读操作检查连接

1. 01
   检查程序与桌面端

   确认实际安装目录里有 CLI 或 MCP 程序，并启动同一用户会话下的 LuckyRay。示例路径只是示例，不要为了匹配文档移动安装目录。

2. 02
   列出当前工具

   使用前面的 tools list 示例查看实际返回。工具列表和参数以当前桌面端提供的内容为准，不根据上游项目猜测可用工具。

3. 03
   执行一次查询

   在已有测试 Vault 中尝试 knowledge.search。检查 JSON 中的执行结果，区分无匹配项、未连接和权限不足。不要以有输出就认定业务调用成功。

4. 04
   再接入宿主

   把生成的配置片段放入宿主支持的 MCP 配置位置，按宿主要求重新加载，并先确认能看到工具列表。写入或其他有影响的操作仍需相应授权。