安裝
npx -y @glyphicjs/mcp-server適合誰
適合要讓模型用 typed JSON 出圖,並且不能接受 DSL 或無頭瀏覽器的人。官方寫法是:模型描述圖,Glyphic 渲染,deterministic SVG & PNG,18 types,validated before it draws,no DSL and no headless browser。
它是你可擁有和繼續構建的 diagram infrastructure,不是線上 Mermaid 託管。輸出可以是 SVG、PNG,或 React Flow JSON。
官方頁面:
https://github.com/MS-Teja/Glyphic
3 分鐘完成第一次嘗試
只走官方 MCP 路徑:stdio via npx,no install。
claude mcp add glyphic -- npx -y @glyphicjs/mcp-server
等價配置是 command 為 npx,args 為 -y 與 @glyphicjs/mcp-server。不要另找未出現的安裝器。官方還寫了庫安裝 npm install @glyphicjs/core @glyphicjs/schema,第一次不要改走庫呼叫。
前置條件:本機能跑 npx。準備一份符合「single validated schema」的 typed JSON,類型先選官方點名的 flowchart。官方沒有給出 JSON 欄位表,缺的鍵不要編。也不要編造 MCP 工具函式名。
設定位置:claude mcp add 或 mcpServers.glyphic。官方安裝註釋只寫到 Claude Code,沒有點名其它客戶端產品或設定檔路徑。
第一次呼叫:讓伺服器渲染這張 flowchart,並只要 SVG。成功訊號:回傳經過校驗後的 SVG(官方寫明 accessible:role="img" + <title>),且沒有啟動瀏覽器。
不要把「無頭瀏覽器」理解成零風險。渲染仍在本機進行,PNG 會走 @resvg/resvg-js(Rust)。JSON 描述會進入渲染行程。
使用案例
案例一:先出一張可縮放向量圖。提交 flowchart 的 typed JSON,取 SVG。官方寫明 pure, scalable vector markup。沒有給出節點數量上限。
案例二:同一份或另一類型要光柵圖,或要可互動畫布資料。取 PNG(high-resolution raster, rendered natively via Rust),或取 React Flow JSON(nodes/edges mapped for an interactive React Flow canvas)。18 類還包括 architecture、sequence、ERD、UML class、state machines、Gantt、timelines、Sankey、Git trees、mindmaps、pie、quadrant、user journeys、Kanban、C4、treemaps 和 freeform canvas。沒有出現的庫函式名不要當回傳入口。
使用邊界
安裝邊界:MCP 主路徑是 npx -y @glyphicjs/mcp-server;庫路徑是另一組 npm 套件,不要和第一次嘗試混用。
能力邊界:18 種類型、一種 schema、三種輸出。官方沒有寫遠端託管、金鑰或瀏覽器預覽。不要假設未列出的圖類型可用。