Skip to content

Release 0.54.2

Latest

Choose a tag to compare

@github-actions github-actions released this 21 Apr 21:49

GNS3 MCP Server v0.54.2

🚀 Quick Installation (Claude Code)

Option 1: Using uvx (Recommended - Faster)

claude mcp add --transport stdio gns3-mcp --env GNS3_HOST=localhost --env GNS3_PORT=80 --env GNS3_USER=admin --env GNS3_PASSWORD=your-password --scope user -- uvx gns3-mcp@latest

Omit default parameters and it would be:

claude mcp add --transport stdio gns3-mcp --env GNS3_HOST=192.168.1.20 --env GNS3_PASSWORD=your-password --scope user -- uvx gns3-mcp@latest

Option 2: Using pip (Traditional)
Step 1: Install package

pip install gns3-mcp

Step 2: Add to Claude Code with credentials

claude mcp add --transport stdio gns3-mcp --env GNS3_HOST=localhost --env GNS3_PORT=80 --env GNS3_USER=admin --env GNS3_PASSWORD=your-password --scope user -- gns3-mcp

Claude Desktop:
Download mcp-server.mcpb → double-click to install → configure credentials in settings.

Cursor/Windsurf:
See full installation guide for JSON configuration examples.

🐳 Docker Deployment (NEW in v0.49.0)

Quick Start with Docker Compose:

  • Download docker-compose.yml and .env.example:
curl -O https://raw.githubusercontent.com/ChistokhinSV/gns3-mcp/master/docker-compose.yml
curl -O https://raw.githubusercontent.com/ChistokhinSV/gns3-mcp/master/.env.example
  • Configure credentials
mv .env.example .env
  • Edit .env with your GNS3 server details

  • Start stack (MCP server + SSH proxy)

docker-compose up -d

Docker Run (MCP server only, SSH proxy in separate container):

docker run -d \
  --name gns3-mcp \
  -p 8000:8000 \
  -e GNS3_HOST=192.168.1.20 \
  -e GNS3_PORT=80 \
  -e GNS3_USER=admin \
  -e GNS3_PASSWORD=your-password \
  chistokhinsv/gns3-mcp:0.54.2

Docker Hub:

  • Image: chistokhinsv/gns3-mcp:0.54.2
  • Tags: 0.54.2, latest
  • Platforms: linux/amd64, linux/arm64
  • View on Docker Hub

Changes

See CHANGELOG.md for details.

Platform

  • Supported: Windows for Desktop Extension (MCPB with UV binary), Linux and macOS for uv/pip and docker installations.
  • Python: 3.10-3.13
  • Built on: windows-latest runner