Network Sketcher (Local MCP)

Install

Pick your client. Read the repository before you give any tool access to your data.

About

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

4 read · 4 write · 1 delete · 3 not yet classified

Secrets

None asked for

Install scripts

None found

Tools (12)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• build_default_outputs

  Generate the default deliverable bundle for a .nsm master. Runs the following three steps in a single call: 1. export combined_diagram --type all_areas Produces FOUR artifacts in one shot: - [L1_DIAGRAM]AllAreasTag_<base>.svg (per-layer side effect) - [L2_DIAGRAM]AllAreas_<base>.svg (per-layer side effect) - [L3_DIAGRAM]AllAreas_<base>.svg (per-layer side effect) - [L1L2L3_DIAGRAM]AllAreas_<base>.html (combined tabbed HTML viewer; primary deliverable) The combined HTML embeds all three layer SVGs in a self-contained page with thre…

• create_empty_master

  Create a new empty Network Sketcher master file (.nsm) in the working dir. The engine's `export master_file_nodata` produces an .xlsx, which this tool immediately converts to .nsm via xlsx_to_nsm() and discards. The xlsx is written to a system temp directory (never to the working directory) so that no .xlsx artefact is left behind. Args: filename: Optional target name. Must start with '[MASTER]' and end with '.nsm'. No path separators allowed. Defaults to '[MASTER]no_data.nsm'. Returns: Result message indicating success and final file path, or an error.

• export_device_table_html

  Export an interactive HTML Device Table preview from a .nsm master. Generates a single self-contained HTML file with four tabs (L1 Table / L2 Table / L3 Table / Attribute) whose layout, styling, and behaviour match the Online edition's Device Preview screen (sticky-header table, per-tab CSV / HTML download buttons, URL-hash initial tab selection). The output file is written next to the master as ``[DEVICE_TABLE]{basename}.html`` and contains no external CDN / script references, so it can be opened directly from disk or shared as a single artifact. PREREQUISITE: call get_ai_context(master) (…

• export_diagram

  Export an L1, L2, or L3 network diagram for the given .nsm master. PREREQUISITE: You MUST have called get_ai_context(master) (or at least get_network_state(master)) at least once in this session for this master so that you understand which layer is meaningful to export given the current network state. Args: master: Master filename inside the working directory. layer: One of 'l1', 'l2', 'l3' (case-insensitive). format: 'svg' (default) or 'pptx'. SVG is faster and renders in the browser. PPTX is editable in PowerPoint. area: Optional area name. When omitted, ever…

• export_master_xlsx

  Convert a .nsm master back to .xlsx for Excel/Offline edition use. The output is placed in the working directory next to the source .nsm, using the same basename with '.xlsx' extension. The .nsm itself is not modified. Args: master: Master filename inside the working directory (e.g. '[MASTER]office.nsm'). Returns: Result message with the produced .xlsx path, or an error.

• get_ai_context

  Generate the full AI Context file for a master and return its contents. This invokes `export ai_context_file` (always with --accept-security-risk to avoid the interactive prompt) and reads back the generated '[AI_Context]<basename>.txt'. The AI Context bundles the network state plus the full CLI command reference, suitable for feeding to a language model that needs to plan multi-step edits. Args: master: Master filename inside the working directory (e.g. '[MASTER]office.xlsx'). Returns: Full text content of the generated AI Context file, or an error.

• get_network_state

  Run the standard set of `show` commands and return aggregated results. This is the lightweight alternative to `get_ai_context`. It produces a plain-text summary of the current network state (areas, devices, interfaces, L1/L2/L3 topology, attributes) by invoking the show commands listed in mcp_config.json -> ai_context_show_commands. Args: master: Master filename inside the working directory (e.g. '[MASTER]office.xlsx'), or an absolute path inside the working directory. Returns: Concatenated stdout from each show command, grouped by command name.

• get_workspace_info

  Return the active workspace and the list of .nsm master files in it. Always safe to call. If no workspace has been set yet, returns workspace_active=false with a reminder to call suggest_workspace(). Returns: JSON string with keys: workspace_active: true/false working_directory: absolute path or null masters: list of .nsm master filenames ('[MASTER]*.nsm') xlsx_masters: list of .xlsx files that need conversion via import_master before they can be used other_files: list of generated outputs (DIAGRAM / AI_Context, etc.) …

• import_master

  Convert an existing .xlsx master into a .nsm in the working directory. The Local MCP edition operates on .nsm files exclusively. Use this tool once at the start of a session to bring an existing .xlsx master under .nsm management. The original .xlsx is left untouched. Args: xlsx_path: Absolute path to the source .xlsx file. The file must exist and have an '.xlsx' extension. The path itself may live outside the working directory. target_name: Optional output filename. Must start with '[MASTER]' and end with '.nsm'. If omitted, the source …

• run_commands

  Execute one or more Network Sketcher CLI commands against a .nsm master. PREREQUISITE: You MUST have called get_ai_context(master) (or at least get_network_state(master)) at least once in this session before using this tool. Without that context you do not know the current state nor the available CLI syntax, and your edits are likely to be wrong. Each non-empty line of `commands` is parsed with shlex and run as a single CLI invocation. Allowed verbs: add, rename, delete, show. `export` is intentionally excluded; use create_empty_master, export_diagram, or get_ai_context instead. The `--mast…

• set_workspace

  Set the active workspace directory for this session. Validates that the path is under the user's home directory (defence against arbitrary filesystem access), creates the directory if it does not exist, and confirms it is writable. Once set, subsequent tool calls operate against this directory until the server restarts or set_workspace is called again. Args: path: Absolute path to the desired workspace. May use '~' for home expansion. Must resolve to a location under Path.home(). Returns: Confirmation message including the resolved absolute path, or an error …

• suggest_workspace

  Suggest OS-appropriate workspace directory candidates. Always safe to call. Returns a list of candidate paths under the user's home directory (Windows / macOS / Linux), with hints about which exist, which are writable, and which the agent should prefer. The agent must propose ONE candidate to the user, get confirmation, then call set_workspace(path). Custom paths under the user home are also acceptable; the candidates are only suggestions. Returns: JSON string with keys: os, current_workspace, home, candidates, guidance

Signals

Stars

413

Forks

24

Open issues

0

Last commit (this folder)

Oct 5, 2026 (23 days ago)

Last release

May 20, 2026 (5 months ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name

io.github.cisco-open/network-sketcher

Version

3.1.2

License

Apache-2.0

Repository

github.com/cisco-open/network-sketcher

Website

github.com/cisco-open/network-sketcher#installation-local-mcp

First seen

Oct 24, 2026

Last checked

Oct 25, 2026

Source

Official MCP Registrygithub-graphql