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

已驗證STDIO僅桌面效率與工作流媒體與設計

概覽

AI 產生的概覽

Lousa 是一個本機 MCP 伺服器加網頁檢視器,讓 AI 代理在即時白板上以手繪動畫圖示的方式畫出解說內容。

可以做什麼
依由方框、箭頭、圓柱、便箋和文字組成的宣告式場景建立白板,回傳白板 id 和檢視器連結,並可替換場景,讓只有變動的元素重新播放動畫。讀取單一白板或列出白板,完成後刪除白板。讀取使用者在檢視器中選取的元素,讓代理精準針對這些元素操作。在瀏覽器分頁中逐筆繪製成手繪風格圖示。
適用情境
適合希望代理以視覺化方式而非大段文字解說架構、流程或概念時使用,也適合在檢視器中點選元素、即時調整圖示的場景。
執行需求
透過 npx 以本機程序執行,需要 Node.js 18.17 或更新版本;stdio 端點會自動啟動本機伺服器,檢視器位於 127.0.0.1:4666。自架共享伺服器時使用 LOUSA_TOKEN、LOUSA_URL、LOUSA_BUCKET、LOUSA_DATA_DIR 等環境變數。
安裝前請注意
白板預設 12 小時後過期(滑動續期),除非將 TTL 設為零,否則內容不會永久保留。自架伺服器時,LOUSA_TOKEN 控管白板列表、建立、刪除和 MCP 端點,而每個白板的連結等同能力連結,持有連結的人即可存取該白板。白板儲存在本機檔案系統或 S3 儲存桶中。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Lousa,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

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_selection and targets exactly that.
  • Boards expire by default (12h, sliding) — a whiteboard, not a document graveyard. ttlHours: 0 keeps a board forever.

Quick start

Requires Node.js 18.17+.

bash
# Claude Codeclaude mcp add lousa -- npx -y lousa mcp
# or run the server directlynpx lousa            # viewer at http://127.0.0.1:4666

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

ToolWhat it does
create_boardCreates a board from a scene, returns {id, url}
update_boardReplaces the scene; unchanged elements stay byte-identical so only changes animate
get_board / list_boardsRead boards
get_selectionWhat the user selected in the viewer (ids + full elements)
delete_boardDeletes a board

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:

bash
LOUSA_TOKEN=<secret> HOST=0.0.0.0 npx lousa        # serverLOUSA_URL=https://your-host LOUSA_TOKEN=<secret> npx lousa mcp   # each client

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.

Env varDefaultPurpose
PORT / HOST4666 / 127.0.0.1server bind
LOUSA_DATA_DIR~/.lousa/boardsfilesystem board storage
LOUSA_BUCKET—use S3 storage instead of filesystem
LOUSA_TOKEN—require bearer token (header or ?t=) on global routes and MCP
LOUSA_URL—lousa mcp proxies to this remote server
LOUSA_DEFAULT_TTL_HOURS12default board expiry

Development

bash
npm installnpm test          # node --testnode cli.js       # local server

License

AGPL-3.0 © Henrique Pires

來源:README.md,提交 c2dd696

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分