@buun_group/plotwork-mcp 0.1.0-beta.8 → 0.1.0

package/README.md

@@ -7,7 +7,7 @@ The Plotwork diagram tools as a local MCP (Model Context Protocol) server. An AI
 | Question | Answer |
 |---|---|
 | Does it need an API key? | No. There is no key, no sign-in, and no account. |
-| Does it use the network? | Not by default. Every tool is a pure computation over its arguments, and with nothing set it reads no file but your repository's settings (`plotwork.config.json`, if you have one), writes none, and makes no network request. Only if you set `PLOTWORK_USAGE` does it count your tool calls, and only if you set it to `share` does it send anything. See [Usage counts](#usage-counts-off-unless-you-turn-them-on). |
+| Does it use the network? | Not by default. Every tool is a pure computation over its arguments, and with nothing set it reads no file but its own (the program, and the icon art in `icons/` beside it) and your repository's settings (`plotwork.config.json`, if you have one), writes none, and makes no network request. Only if you set `PLOTWORK_USAGE` does it count your tool calls, and only if you set it to `share` does it send anything. See [Usage counts](#usage-counts-off-unless-you-turn-them-on). |
 | How do I start it? | `npx -y @buun_group/plotwork-mcp`. Your MCP client runs this command for you. |
 | Which Node version? | Node 22 or newer. |
 | What are the tools? | Workflows that draw a diagram, convert Mermaid, choose icons, and sync a Markdown document in one call, and single steps for fine control. All are read-only. Your client lists them, and the tool reference in the documentation has every name and schema. |
@@ -76,6 +76,10 @@ Add this to `claude_desktop_config.json`, then restart Claude Desktop:
 
 Any client that starts an MCP server as a local process takes the same two parts: the command `npx` and the arguments `-y @buun_group/plotwork-mcp`.
 
+### Open and self-hosted models
+
+A model with a small context (an open model on Ollama, LM Studio, vLLM, or llama.cpp) does better with fewer tools. Add `--tools core` to the arguments, or set `PLOTWORK_TOOLS=core`, and the server lists only its eight workflow tools with short descriptions: about 1,700 tokens instead of about 17,500. The tools answer the same. See [Use Plotwork with open and self-hosted models](https://docs.plotwork.dev/mcp/open-models).
+
 ## Check it by hand
 
 ```sh

package/THIRD-PARTY-NOTICES.md

@@ -1,6 +1,6 @@
 # Third-party notices
 
-@buun_group/plotwork-mcp 0.1.0-beta.8 is licensed under the MIT licence, in the file LICENSE. The single file plotwork-mcp.mjs also contains code and data from other people. This file lists them, with the licence each is used under and the full licence text. Those licences apply to that material. The MIT licence of @buun_group/plotwork-mcp does not replace them, and it does not cover the vendor artwork described under "Trademarks and official icons".
+@buun_group/plotwork-mcp 0.1.0 is licensed under the MIT licence, in the file LICENSE. The single file plotwork-mcp.mjs also contains code and data from other people. This file lists them, with the licence each is used under and the full licence text. Those licences apply to that material. The MIT licence of @buun_group/plotwork-mcp does not replace them, and it does not cover the vendor artwork described under "Trademarks and official icons".
 
 The build writes this file from the contents of the bundle. Do not edit it.
 
@@ -97,7 +97,7 @@ The build writes this file from the contents of the bundle. Do not edit it.
 - Licence declared: CC0-1.0
 - Used under: CC0-1.0
 - Repository: https://github.com/simple-icons/simple-icons
-- What is in the bundle: The path data of each brand mark, copied by gen:icons into a generated module and drawn as inline SVG.
+- What is in the bundle: The path data of each brand mark, copied by gen:icons into a generated module and drawn as inline SVG. gen:icon-art splits it into the catalog the bundle holds, with the paths of the marks most diagrams draw, and the shards in icons/simple/ beside the bundle, which hold every path.
 - Copyright: No copyright line in the licence file. The package names Simple Icons Collaborators as its author.
 - NOTICE file: none shipped
 - Licence text: [text 6](#licence-text-6)
@@ -109,7 +109,7 @@ The build writes this file from the contents of the bundle. Do not edit it.
 - Licence declared: CC0-1.0
 - Used under: CC0-1.0
 - Repository: https://github.com/gilbarbara/logos
-- What is in the bundle: The full colour file of each of a few brand marks that Simple Icons does not publish, copied by gen:icons into a generated module as the text of a standalone SVG and drawn unmodified, as an image, on a light tile.
+- What is in the bundle: The full colour file of each of a few brand marks that Simple Icons does not publish, copied by gen:icons into a generated module as the text of a standalone SVG and drawn unmodified, as an image, on a light tile. gen:icon-art keeps the files most diagrams draw in the bundle and every file in the shards in icons/simple/ beside it.
 - Copyright: No copyright line in the licence file.
 - Licence file: the package ships none, so the licence text its authors publish is used, from https://raw.githubusercontent.com/gilbarbara/logos/master/LICENSE.txt
 - NOTICE file: none shipped