GNS3 MCP icon: a gecko climbing a network graph

GNS3 MCP Server

Let AI agents build, wire, configure and troubleshoot your GNS3 network labs.

An MCP server for GNS3 3.x. Your agent gets tools to:

You need a GNS3 3.x server (the GNS3 VM or gns3server) and uv.

Install

Let your agent do it

Paste this into Claude Code, Codex, Cursor or any other agent that can run commands:

Install the GNS3 MCP server from https://chistokhinsv.github.io/gns3-mcp

It follows the steps for agents below, asks you for the GNS3 server details, and runs the setup. You can type the password into your own terminal instead of giving it to the agent.

Or install it yourself

  1. Install uv if uvx --version does not work, then open a new terminal.
    Windows
    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
    macOS / Linux
    curl -LsSf https://astral.sh/uv/install.sh | sh
  2. Connect your agent. Run this with your agent's name from the table below. It asks for the GNS3 host, port, user and password, checks the login, and sets the agent up:
    uvx gns3-mcp configure claude
    NameAgent
    claudeClaude Code
    claude-desktopClaude Desktop
    cursorCursor
    vscodeGitHub Copilot in VS Code
    windsurfWindsurf (Devin Desktop)
    clineCline
    kiroKiro
    opencodeOpenCode
    codexOpenAI Codex
    geminiGemini CLI

    Agent not listed, or you prefer to edit the config yourself? This prints the ready-made config and instructions for every agent, with the file paths for your computer:

    uvx gns3-mcp configure --instructions
  3. Restart the agent and ask it: "List my GNS3 projects".

What it changes

Useful options: --project writes the config into the current folder instead of the user-wide one, and --dry-run shows the changes first.

Other ways

Instructions for AI agents

If you are an AI agent installing this server for the user, follow install.md. In short:

  1. Pick your name from the table above, or ask the user. If you are not listed, run uvx gns3-mcp configure --instructions and follow the guide it prints.
  2. Check uvx --version. If uv is missing, ask the user before installing it.
  3. Ask the user for the GNS3 host, the port (80 on the GNS3 VM, 3080 for gns3server) and the username.
  4. Ask the user to run uvx gns3-mcp configure <name> in their own terminal, which keeps the password out of the chat. If they ask you to run it, pass the password only in the GNS3_PASSWORD environment variable, add --host --port --user --yes, and never repeat the password.
  5. Check that the output says login check: OK, then tell the user to restart the agent.