Back to Home
ChistokhinSV icon

gns3-mcp

by ChistokhinSV

Overview

A FastAPI service that acts as a Model Context Protocol (MCP) server for GNS3, enabling AI agents to automate network lab creation, configuration, and troubleshooting through SSH, console, TFTP, and HTTP proxy functionalities.

Installation

Run Command
docker-compose up -d gns3-ssh-proxy-main

Environment Variables

  • GNS3_HOST
  • GNS3_PORT
  • GNS3_USERNAME
  • GNS3_PASSWORD
  • GNS3_USE_HTTPS
  • GNS3_VERIFY_SSL
  • SSH_PROXY_URL
  • HTTP_HOST
  • HTTP_PORT
  • LOG_LEVEL
  • MCP_API_KEY
  • USER
  • PASSWORD

Security Notes

The system utilizes an SSH proxy service that exposes a `/local/execute` endpoint, allowing arbitrary commands to be run via `subprocess.run(shell=True)` without explicit input sanitization. This is a critical remote code execution vulnerability if the proxy is exposed or compromised. Although intended for local execution within a Docker container, this pattern introduces significant risk. API key authentication is implemented for HTTP transport, but if `MCP_API_KEY` is not set, it's auto-generated and logged, which could expose it if logs are accessible. The `verify_ssl=False` option for GNS3 connections, while practical for self-signed certificates in labs, reduces overall security by disabling certificate validation.

Similar Servers

Stats

Interest Score30
Security Score5
Cost ClassMedium
Avg Tokens1000
Stars1
Forks0
Last Update2025-11-30

Tags

GNS3network automationAI agentlab managementSSHconsoleTFTPHTTP proxyDocker