vizo-mcp 0.1.0 → 0.3.0

package/README.md

@@ -3,9 +3,22 @@
 stdio MCP proxy for a [Vizo](https://vizo.twinkle.hk) whiteboard server, for MCP clients that only speak stdio.
 
 ```sh
-claude mcp add vizo -- npx -y vizo-mcp --url https://vizo.twinkle.hk --token vz_…
+claude mcp add vizo -- npx -y vizo-mcp@latest --url https://vizo.twinkle.hk --token vz_…
 ```
 
 Create a token at `<url>/settings`. `VIZO_URL` and `VIZO_TOKEN` work instead of the flags.
 
-Diagrams (`draw_diagram`, `update_diagram`) are laid out on your machine and sent to the server finished. The proxy's layout version must match the server's: if they differ, the server refuses the call and asks you to update, e.g. `npx -y vizo-mcp@latest`.
+Diagrams (`draw_diagram`, `update_diagram`) are laid out on your machine and sent to the server finished. The proxy's layout version must match the server's: if they differ, the server refuses the call and asks you to update. With `vizo-mcp@latest` in the command, as above, restarting your MCP client is enough: npx checks for a newer version on each start (without `@latest` it keeps reusing the copy it cached first).
+
+## Adding images
+
+`add_image` also takes a local file `path` here: the proxy reads the file and uploads it. The image is placed on the board, or with `place: false` only uploaded, and the returned `fileId` can be used as a flowchart or component node's `image` to show the picture in a diagram.
+
+## Exporting images
+
+The proxy adds an `export_image` tool: it saves a board, or chosen diagrams or elements, as PNG or SVG on your machine. It also returns a small preview, so the agent can check what it drew. Rendering happens locally: the server only hands over the board's elements and images (`get_board_scene`, which only the proxy can see). It uses the same hand-drawn strokes and fonts as the editor.
+
+- SVG files embed the fonts they use.
+- PNGs are drawn with [resvg](https://github.com/RazrFalcon/resvg). Characters the bundled fonts lack (e.g. Chinese, Japanese) use a system font. Emoji are left out of PNGs, because resvg can't draw color emoji fonts; SVGs keep them.
+- Fonts are Excalidraw's, under their own licenses: see `fonts/README.md`.
+

package/dist/fonts/fonts.json

@@ -0,0 +1,146 @@
+[
+ {
+  "family": "Excalifont",
+  "id": 5,
+  "file": "Excalifont-Regular-a88b72a24fb54c9f94e3b5fdaa7481c9.woff2",
+  "unicodeRange": "U+20-7e,U+a0-a3,U+a5-a6,U+a8-ab,U+ad-b1,U+b4,U+b6-b8,U+ba-ff,U+131,U+152-153,U+2bc,U+2c6,U+2da,U+2dc,U+304,U+308,U+2013-2014,U+2018-201a,U+201c-201e,U+2020,U+2022,U+2024-2026,U+2030,U+2039-203a,U+20ac,U+2122,U+2212",
+  "ttfFamily": "Excalifont"
+ },
+ {
+  "family": "Excalifont",
+  "id": 5,
+  "file": "Excalifont-Regular-be310b9bcd4f1a43f571c46df7809174.woff2",
+  "unicodeRange": "U+100-130,U+132-137,U+139-149,U+14c-151,U+154-17e,U+192,U+1fc-1ff,U+218-21b,U+237,U+1e80-1e85,U+1ef2-1ef3,U+2113",
+  "ttfFamily": "Excalifont 2"
+ },
+ {
+  "family": "Excalifont",
+  "id": 5,
+  "file": "Excalifont-Regular-b9dcf9d2e50a1eaf42fc664b50a3fd0d.woff2",
+  "unicodeRange": "U+400-45f,U+490-491,U+2116",
+  "ttfFamily": "Excalifont 3"
+ },
+ {
+  "family": "Excalifont",
+  "id": 5,
+  "file": "Excalifont-Regular-41b173a47b57366892116a575a43e2b6.woff2",
+  "unicodeRange": "U+37e,U+384-38a,U+38c,U+38e-393,U+395-3a1,U+3a3-3a8,U+3aa-3cf,U+3d7",
+  "ttfFamily": "Excalifont 4"
+ },
+ {
+  "family": "Excalifont",
+  "id": 5,
+  "file": "Excalifont-Regular-3f2c5db56cc93c5a6873b1361d730c16.woff2",
+  "unicodeRange": "U+2c7,U+2d8-2d9,U+2db,U+2dd,U+302,U+306-307,U+30a-30c,U+326-328,U+212e,U+2211,U+fb01-fb02",
+  "ttfFamily": "Excalifont 5"
+ },
+ {
+  "family": "Excalifont",
+  "id": 5,
+  "file": "Excalifont-Regular-349fac6ca4700ffec595a7150a0d1e1d.woff2",
+  "unicodeRange": "U+462-463,U+472-475,U+4d8-4d9,U+4e2-4e3,U+4e6-4e9,U+4ee-4ef",
+  "ttfFamily": "Excalifont 6"
+ },
+ {
+  "family": "Excalifont",
+  "id": 5,
+  "file": "Excalifont-Regular-623ccf21b21ef6b3a0d87738f77eb071.woff2",
+  "unicodeRange": "U+300-301,U+303",
+  "ttfFamily": "Excalifont 7"
+ },
+ {
+  "family": "Nunito",
+  "id": 6,
+  "file": "Nunito-Regular-XRXI3I6Li01BKofiOc5wtlZ2di8HDIkhdTk3j6zbXWjgevT5.woff2",
+  "unicodeRange": "U+0460-052F, U+1C80-1C88, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F",
+  "ttfFamily": "Nunito 2"
+ },
+ {
+  "family": "Nunito",
+  "id": 6,
+  "file": "Nunito-Regular-XRXI3I6Li01BKofiOc5wtlZ2di8HDIkhdTA3j6zbXWjgevT5.woff2",
+  "unicodeRange": "U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116",
+  "ttfFamily": "Nunito 3"
+ },
+ {
+  "family": "Nunito",
+  "id": 6,
+  "file": "Nunito-Regular-XRXI3I6Li01BKofiOc5wtlZ2di8HDIkhdTs3j6zbXWjgevT5.woff2",
+  "unicodeRange": "U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB",
+  "ttfFamily": "Nunito 4"
+ },
+ {
+  "family": "Nunito",
+  "id": 6,
+  "file": "Nunito-Regular-XRXI3I6Li01BKofiOc5wtlZ2di8HDIkhdTo3j6zbXWjgevT5.woff2",
+  "unicodeRange": "U+0100-02AF, U+0304, U+0308, U+0329, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F, U+A720-A7FF",
+  "ttfFamily": "Nunito 5"
+ },
+ {
+  "family": "Nunito",
+  "id": 6,
+  "file": "Nunito-Regular-XRXI3I6Li01BKofiOc5wtlZ2di8HDIkhdTQ3j6zbXWjgeg.woff2",
+  "unicodeRange": "U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD",
+  "ttfFamily": "Nunito"
+ },
+ {
+  "family": "Lilita One",
+  "id": 7,
+  "file": "Lilita-Regular-i7dPIFZ9Zz-WBtRtedDbYE98RXi4EwSsbg.woff2",
+  "unicodeRange": "U+0100-02AF, U+0304, U+0308, U+0329, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C0, U+2113, U+2C60-2C7F, U+A720-A7FF",
+  "ttfFamily": "Lilita One 2"
+ },
+ {
+  "family": "Lilita One",
+  "id": 7,
+  "file": "Lilita-Regular-i7dPIFZ9Zz-WBtRtedDbYEF8RXi4EwQ.woff2",
+  "unicodeRange": "U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+2074, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD",
+  "ttfFamily": "Lilita One"
+ },
+ {
+  "family": "Comic Shanns",
+  "id": 8,
+  "file": "ComicShanns-Regular-279a7b317d12eb88de06167bd672b4b4.woff2",
+  "unicodeRange": "U+20-7e,U+a1-a6,U+a8,U+ab-ac,U+af-b1,U+b4,U+b8,U+bb-bc,U+bf-cf,U+d1-d7,U+d9-de,U+e0-ef,U+f1-f7,U+f9-ff,U+131,U+152-153,U+2c6,U+2da,U+2dc,U+2013-2014,U+2018-201a,U+201c-201d,U+2020-2022,U+2026,U+2039-203a,U+2044,U+20ac,U+2191,U+2193,U+2212",
+  "ttfFamily": "Comic Shanns"
+ },
+ {
+  "family": "Comic Shanns",
+  "id": 8,
+  "file": "ComicShanns-Regular-fcb0fc02dcbee4c9846b3e2508668039.woff2",
+  "unicodeRange": "U+100-10f,U+112-125,U+128-130,U+134-137,U+139-13c,U+141-148,U+14c-151,U+154-161,U+164-165,U+168-17f,U+1bf,U+1f7,U+218-21b,U+237,U+1e80-1e85,U+1ef2-1ef3,U+a75b",
+  "ttfFamily": "Comic Shanns 2"
+ },
+ {
+  "family": "Comic Shanns",
+  "id": 8,
+  "file": "ComicShanns-Regular-dc6a8806fa96795d7b3be5026f989a17.woff2",
+  "unicodeRange": "U+2c7,U+2d8-2d9,U+2db,U+2dd,U+315,U+2190,U+2192,U+2200,U+2203-2204,U+2264-2265,U+f6c3",
+  "ttfFamily": "Comic Shanns 3"
+ },
+ {
+  "family": "Comic Shanns",
+  "id": 8,
+  "file": "ComicShanns-Regular-6e066e8de2ac57ea9283adb9c24d7f0c.woff2",
+  "unicodeRange": "U+3bb",
+  "ttfFamily": "Comic Shanns 4"
+ },
+ {
+  "family": "Virgil",
+  "id": 1,
+  "file": "Virgil-Regular.woff2",
+  "ttfFamily": "Virgil"
+ },
+ {
+  "family": "Cascadia",
+  "id": 3,
+  "file": "CascadiaCode-Regular.woff2",
+  "ttfFamily": "Cascadia"
+ },
+ {
+  "family": "Liberation Sans",
+  "id": 9,
+  "file": "LiberationSans-Regular.woff2",
+  "ttfFamily": "Liberation Sans"
+ }
+]