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@latestOmit 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@latestOption 2: Using pip (Traditional)
Step 1: Install package
pip install gns3-mcpStep 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-mcpClaude 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 -dDocker 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.2Docker 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