Freero

io.github.antonber由 GitHub 帳號 antonber 發布v0.1.0更新於 Nov 5, 2026

A collaborative whiteboard your AI assistant can read, fill and show live, with changes you review.

已驗證Streamable HTTP可網頁執行效率與工作流溝通與協作

概覽

AI 產生的概覽

把 AI 助理接上 Freero 協作白板，可讀取、填寫並即時展示內容，變更由你審核。

可以做什麼
  • 讀取與填寫白板內容：便利貼、形狀、富文字、連接線、圖片、畫框、任務卡與心智圖
  • 即時展示白板變更供你審核，而不是默默套用
  • 操作無限畫布，支援縮放平移、群組、鎖定與復原重做
  • 搭配留言、角色權限、分享與簡報模式等協作功能
  • 使用範本，並將白板匯出為圖片或把畫框匯出為 PDF
適用情境
適合讓助理在共用畫布上草擬或填寫圖表、心智圖與工作坊白板，或在團隊面前即時展示白板內容，同時由你逐項審核變更。
執行需求
透過 streamable HTTP 連線至 freero.app 的遠端 MCP 端點，需要 OAuth 登入。未宣告環境變數或標頭。自架專案本身需要 Node 22+ 與資料庫，但使用託管端點時不需要。
安裝前請注意
此伺服器可寫入共用白板，助理所做的變更會呈現給協作者，接受前請先審核。存取權限透過 OAuth 授予你的 Freero 帳號與白板，請只授權給你願意曝露其白板的帳號。白板內容由託管服務儲存。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Freero，將其新增到工作區。
  2. 連接 所需的 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.antonber%2Ffreero/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。 客戶端會在首次連接時完成 OAuth 登入。

{
  "mcpServers": {
    "freero": {
      "type": "http",
      "url": "https://freero.app/mcp"
    }
  }
}

README

Freero

An original real-time collaborative whiteboard: an infinite canvas for teams to brainstorm, plan, diagram and run workshops together.

What's in it

  • Canvas — infinite pan/zoom, dot grid, minimap, snapping and alignment guides, multi-select, resize/rotate, groups, lock, undo/redo, copy/paste across boards, drag-and-drop import.
  • Content — sticky notes, 21 shapes, rich text, connectors (straight/elbow/curved, attached, labelled), pen + highlighter + eraser, images, emoji and stamps, frames, task cards, mind maps, tags, PDFs, video and audio that play on the board, and file cards for any other file.
  • Collaboration — live sync, cursors and selections, avatars, follow a collaborator, "bring everyone to me", emoji reactions, comment threads, owner/editor/commenter/viewer roles, share by invite or link.
  • Facilitation — voting sessions, a shared timer, presentation mode over frames.
  • Templates & export — 180 original templates in 18 categories; export PNG/JPG/SVG, frames to PDF, copy as image.
  • Dashboard — boards grid/list, search, filters, stars, live thumbnails, duplicate, sharing.

Run it

Requires Node 22+.

bash
npm installnpm run dev          # server on :4000 + web on :5173

Open http://localhost:5173 and log in with the seeded demo account [email protected] / freero123 (development only), or sign up. http://localhost:5173/board/local is an offline sandbox board that needs no server.

Production:

bash
npm run build && npm start     # serves the built web app and the marketing site (apps/site) on :4000docker compose up --build -d   # or the full stack: proxy, 2 app replicas, Postgres, Redis, MinIO, Mailpit on :8080

Deploying for real: docs/deployment.md · every setting: docs/configuration.md · backups, monitoring, incidents: docs/operations.md.

Configuration: PORT (default 4000), FREERO_DATA_DIR (default ./data — the built-in PGlite database in data/pg + uploads), DATABASE_URL (use a real Postgres instead), DATABASE_POOL_MAX (default 10). Had boards from before the move to Postgres? Stop the dev server and run npm run db:import-sqlite once.

Develop

CommandWhat it does
npm run checkArchitecture boundaries + typecheck + unit tests
npm run verifyReal-session end-to-end check: real server, real Yjs WebSocket clients, roles, persistence
npm run new:feature <name> -- …Scaffold a feature folder (see ARCHITECTURE.md)
node scripts/ui-shot.mjs --url … --out …Drive the real UI in headless Chromium and screenshot it

Freero follows the Dune method: features are isolated folders discovered by reserved file names, every piece of state has one writer, and forbidden dependencies fail npm run check with an error that names the supported path. Read ARCHITECTURE.md before changing code.

Stack: React 18 + TypeScript + Vite, Yjs (CRDT) over WebSockets, Express + ws, PostgreSQL (pg; PGlite for dev/tests), Playwright for UI verification.

License

MIT. Dependencies are kept to permissive licences (MIT, Apache-2.0, MPL-2.0); GPL, AGPL and source-available projects are integrated at the protocol level only, never vendored.

來源：README.md，提交 f15e7ea

工具

0
該伺服器需要登入，因此 SourceWeft 無法在沒有帳號的情況下讀取其工具，也未收錄。已連接帳號所能看到的內容可能因帳號及其權限而異。

版本歷史

1
  1. v0.1.0最新Nov 5, 2026

評分

已滿足適用檢查項的 85%

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

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具15 分

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

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