跳到正文
DEV Community· Mahtabul Al Nahian·· 15 天前AI 評分38

Lore Solo 加入 doctor 命令,檢查大學共用電腦的 MCP 設定環境

I added a doctor command so university lab PCs stop failing Mid-MCP setup

AI 導讀

Lore Solo 0.1.2 加入 doctor 命令,檢查大學共用電腦執行 MCP setup 前的環境問題。命令會檢查 uv、Node.js 18+ 和 ~/.lore 的寫入權限,並按作業系統提供安裝提示。缺少必需工具時會回傳退出碼 1;Graphify 地圖和編輯器偵測則屬非必需項目。

正文

Mahtabul Al Nahian

Shared lab machines are where polite README quick starts go to die.

I maintain Lore Solo — a local MCP helper that routes coding-agent tasks to approved persona skills instead of dumping a whole skill binder into context. The happy path is short:

uvx lore-solo install
uvx lore-solo setup
uvx lore-solo connect

On a university library PC that path fails for boring reasons: no uv, Node 16 instead of 18+, home directory locked down, Graphify missing so the map step looks broken, or no editor config folder for connect to write into. None of that is mysterious. It is just expensive to discover after the first npm ci.

What 0.1.2 adds

uvx lore-solo doctor

Or from a clone of the solo branch:

./scripts/lore-solo doctor
# Windows: .\scripts\lore-solo.ps1 doctor

Doctor checks, for the OS you are on:

Check Required? If missing
uv yes no uvx / install
Node.js 18+ yes setup site will not run
npm yes first setup build fails
write access to ~/.lore yes install cannot land
installed lore-solo binary no editors that expect ~/.lore/bin miss it; uvx still works
Graphify map no no codebase map; personas still work
detected editors no connect has nowhere to register; project .cursor/mcp.json backup still works

Missing items print an OS-specific install hint (curl vs PowerShell for uv, brew / winget / nodejs.org for Node, VS Build Tools note for the optional map on Windows) and a one-line "without this you lose…" note. Exit code 1 means a required tool is missing.

Why bother

Most MCP tutorials assume a developer laptop. Building Your First MCP Server and FastMCP walkthroughs get the protocol right. Lab PCs fail earlier: package managers, Node major versions, and writable homes. Cursor MCP setup guides help once the binary exists; doctor is the gate before that.

The README now has an explicit prerequisites table for the same reason. Doctor is the executable version of that table.

Try it

uvx lore-solo doctor
uvx lore-solo install
uvx lore-solo setup

Repo / branch: starrynight-web/LORE solo. Package: lore-solo 0.1.2 on PyPI once the release is published.

If you ship local MCP tools for classrooms or club machines, a doctor/check command pays for itself the first time Node is too old and the error is three screens deep in a Next build log.

來源:DEV Community · dev.to