mirror of https://github.com/GNS3/gns3-server.git synced 2026-08-27 12:30:13 +03:00

Make AI features (AI Copilot + MCP) optional via [ai-features] extra

- Move fastmcp from core requirements.txt to mcp-requirements.txt
- Add MCP_AVAILABLE feature flag in agent/__init__.py (graceful degradation)
- Guard MCP imports/registration in server.py and tasks.py
- Replace ai-copilot/mcp/ai-support extras with single ai-features extra
- Add stub MCP routes returning 501 when MCP is not installed
- Add gns3server-uninstall-ai-features CLI command
- Remove old gns3server-uninstall-ai-copilot command
- Update all error messages and docs to reference ai-features

Closes #2794

2026-06-27 10:14:43 +08:00

2.7 KiB

Raw Blame History

Ubuntu 24.04 GNS3 Development Environment Setup

Simplified Development Environment Setup

1. Add PPA

sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository ppa:gns3/ppa
sudo apt update

2. Install Dependencies

Binary tools (Dynamips, VPCS, uBridge, etc.) are automatically installed as gns3-server dependencies

sudo apt install gns3-server tshark

3. Remove gns3-server While Keeping Dependencies

If you only want to run the server from source:

# Remove main package only, keep dependencies
sudo apt remove gns3-server

# Mark dependencies as manual to prevent autoremove deletion
sudo apt-mark manual ubridge dynamips vpcs libvirt

4. Install and Start Docker

sudo apt install docker.io
sudo systemctl enable --now docker

Configure Docker Mirror Accelerator (China Mainland)

If Docker Hub is inaccessible, configure mirror accelerators:

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<'EOF'
{
  "registry-mirrors": [
    "https://docker.1ms.run",
    "https://docker.xuanyuan.me"
  ]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

Verify:

docker info | grep -i mirror

5. Add User to Groups

# If running as gns3 user (created by PPA install):
sudo usermod -aG ubridge,docker,kvm gns3

# If running as your own user, add yourself to these groups:
sudo usermod -aG ubridge,docker,kvm $USER

# Then logout and login again for group membership to take effect

6. Install Python venv

sudo apt install python3.12-venv

7. Run Development Version from Source

Clone the repository (official or your fork):

# Official repository
git clone https://github.com/GNS3/gns3-server.git

# Or your forked repository
git clone https://github.com/yourname/gns3-server.git
cd gns3-server
git checkout your-branch

Setup virtual environment and install dependencies:

python3 -m venv venv
source venv/bin/activate

# For China mainland users, use mirror:
# pip install -e . -i https://mirrors.aliyun.com/pypi/simple/

pip install -e . && gns3server-web-wireshark-setup
pip install -e .[ai-features]
pip install -e .[dev]

Run the server:

python3 -m gns3server

Optional: Install AI Features Development Dependencies

python3 -m pip install .[ai-features,dev]

Optional: Expand LVM Root Partition

If the root partition is low on space but the volume group has unallocated space:

Check LVM status:

sudo lvm pvdisplay
sudo lvm vgdisplay
sudo lvm lvdisplay

Extend the root LV using all free space:

sudo lvm lvextend -l +100%FREE /dev/mapper/ubuntu--vg-ubuntu--lv
sudo resize2fs /dev/mapper/ubuntu--vg-ubuntu--lv