
Lousa
io.github.henriquepe由 GitHub 帳號 henriquepe 發布v0.1.1更新於 Oct 24, 2026
A whiteboard where AI agents draw their explanations as hand-drawn animated diagrams
概覽
Lousa 是一個本機 MCP 伺服器加網頁檢視器,讓 AI 代理在即時白板上以手繪動畫圖示的方式畫出解說內容。
- 可以做什麼
- 依由方框、箭頭、圓柱、便箋和文字組成的宣告式場景建立白板,回傳白板 id 和檢視器連結,並可替換場景,讓只有變動的元素重新播放動畫。讀取單一白板或列出白板,完成後刪除白板。讀取使用者在檢視器中選取的元素,讓代理精準針對這些元素操作。在瀏覽器分頁中逐筆繪製成手繪風格圖示。
- 適用情境
- 適合希望代理以視覺化方式而非大段文字解說架構、流程或概念時使用,也適合在檢視器中點選元素、即時調整圖示的場景。
- 執行需求
- 透過 npx 以本機程序執行,需要 Node.js 18.17 或更新版本;stdio 端點會自動啟動本機伺服器,檢視器位於 127.0.0.1:4666。自架共享伺服器時使用 LOUSA_TOKEN、LOUSA_URL、LOUSA_BUCKET、LOUSA_DATA_DIR 等環境變數。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Lousa,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
Lousa
A whiteboard where your AI agent draws its explanations.
[Your agent drawing a rate limiter explanation, stroke by stroke]
Ask your agent "explain this visually" and it sketches an animated, hand-drawn diagram on a live board — instead of another wall of text. Lousa is an MCP server + web viewer: the agent authors a declarative scene (boxes, arrows, cylinders, notes), and the board renders it stroke by stroke, as if someone were drawing it in front of you.
Lousa is Portuguese for the classic school blackboard.
Why it's different
- The agent is the artist. No prompt box, no OCR — your coding agent already has the context and draws through typed MCP tools.
- Live, incremental drawing. Follow-ups edit the scene; the open tab animates only what changed, like watching the diagram evolve.
- Point at things. Click elements in the viewer to select them, then tell your agent "improve what I selected" — it reads your selection through
get_selectionand targets exactly that. - Boards expire by default (12h, sliding) — a whiteboard, not a document graveyard.
ttlHours: 0keeps a board forever.
Quick start
Requires Node.js 18.17+.
Any MCP host works — for stdio configuration use command npx, args ["-y", "lousa", "mcp"]. The stdio endpoint auto-starts the local server, so the viewer is always available. Then ask your agent to "draw how our auth flow works" and open the URL it returns.
MCP tools
The scene is a JSON array of elements — box, ellipse, diamond, cylinder, arrow (connects ids), line, text, note — rendered with rough.js. The full schema ships inside the tool definitions; agents need no extra setup.
Self-hosting a shared server
Run lousa on any Node host and point machines at it:
LOUSA_TOKEN gates board listing/creation/deletion and /mcp; per-board URLs act as capability links. AWS Lambda + S3 deployment is supported out of the box (lambda.js handler + LOUSA_BUCKET for storage); any HTTPS front (API Gateway, etc.) works.
Development
License
AGPL-3.0 © Henrique Pires
來源:README.md,提交 c2dd696
工具
0版本歷史
1- v0.1.1最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分