MatPlotLibNet.Mcp
1.15.0
See the version list below for details.
{ "inputs": [ { "type": "promptString", "id": "MATPLOTLIBNET_MCP_OUTPUT_ROOT", "description": "The only directory save_chart may write under. Defaults to the system temp directory." } ], "servers": { "MatPlotLibNet.Mcp": { "type": "stdio", "command": "dnx", "args": ["MatPlotLibNet.Mcp@1.15.0", "--yes"], "env": { "MATPLOTLIBNET_MCP_OUTPUT_ROOT": "${input:MATPLOTLIBNET_MCP_OUTPUT_ROOT}" } } } }
.vscode/mcp.json settings file.
dotnet tool install --global MatPlotLibNet.Mcp --version 1.15.0
dotnet new tool-manifest
dotnet tool install --local MatPlotLibNet.Mcp --version 1.15.0
#tool dotnet:?package=MatPlotLibNet.Mcp&version=1.15.0
nuke :add-package MatPlotLibNet.Mcp --version 1.15.0
MatPlotLibNet.Mcp
An MCP (Model Context Protocol) server for MatPlotLibNet. It gives an AI agent — Claude Code, VS Code, Claude Desktop, any MCP host — four tools:
| tool | what it does |
|---|---|
render_chart |
renders a chart spec to a PNG image the model can look at |
save_chart |
writes the chart as PNG, SVG or PDF to a file and returns the path it wrote |
list_chart_types |
the chart types the spec accepts, read off the library's own registry |
describe_chart_schema |
the fields of the spec, and a worked example for a chart type |
The server speaks stdio. It is a .NET tool: a host runs it with dnx MatPlotLibNet.Mcp (the .NET 10 SDK
resolves and starts it), or with dotnet tool exec MatPlotLibNet.Mcp.
{
"servers": {
"MatPlotLibNet.Mcp": {
"type": "stdio",
"command": "dnx",
"args": ["MatPlotLibNet.Mcp", "--yes"]
}
}
}
The spec
The spec is the library's own figure JSON — the same document figure.ToJson() writes and
ChartSerializer.FromJson reads — so anything the library can draw, the agent can ask for:
{
"width": 800, "height": 600, "title": "Revenue",
"subPlots": [{
"series": [{ "type": "line", "xData": [1, 2, 3, 4, 5], "yData": [2, 4, 3, 5, 1], "label": "Q1" }]
}]
}
The server checks the spec before it renders: an unknown field, an unknown chart type, a misspelled enum value, a colour the library does not know, a missing size — each is refused with a message that names the offending field, so the model can correct itself instead of receiving a blank picture.
What comes back
render_chart returns the PNG as an image block and, beside it, a short text summary (chart types, series,
axis ranges) so a model that cannot see the image still knows what it made. SVG and PDF are large; they go
to a file through save_chart, never inline.
The SVG this server writes carries text as glyph outlines (<path>), not <text> elements — the PNG
backend is loaded in the same process, and the library then embeds its own font so the drawing is identical
everywhere.
Limits
save_chartwrites only under one directory: the system temp directory, or the one named by theMATPLOTLIBNET_MCP_OUTPUT_ROOTenvironment variable. It never overwrites an existing file unless asked.- A canvas larger than the documented ceiling is refused with the ceiling in the message.
License
MIT — see the repository.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
This package has no dependencies.