gns3-server/.claude/memory/MEMORY.md

GNS3 Server Project Memory

Note

: This directory stores important project-related memories and case studies, managed with the code repository.

How to record: Use the /memory skill to record important information to the project memory directory.

Quick Reference

• Memory directory: .claude/memory/
• Skill file: .claude/skills/memory/SKILL.md
• Main index: MEMORY.md (this file)

Topics

Web Wireshark Integration

• JWT Token Flow - JWT token transmission path in Web Wireshark
  • Key point: UDPLink only passes through jwt_token, ultimately used by curl command inside Web Wireshark container to authenticate with GNS3 capture stream API
• Xpra HTML5 Client - Xpra HTML5 client menu control parameters for customizing the web interface

RBAC & User Isolation

• RBAC User Isolation Design — Three-step permission check design: ACE batch check → created_by filtering → resource pools

Appliance Management

• GNS3 Appliance Loading - How GNS3 loads appliance files from builtin and custom directories with priority rules

uBridge Permission

• uBridge Permission Issue - Docker containers fail to start due to missing CAP_NET_ADMIN/CAP_NET_RAW capabilities on uBridge

Docker Container Stop Delay

• Docker Container Stop Delay - Some containers take ~5s to stop because they don't handle SIGTERM (AlpiNet, OstinatoWireshark)

MCP Service

• MCP Service Design - MCP (Model Context Protocol) service architecture using FastMCP with SSE transport, JWT auth, 29 tools across 5 domains
• MCP Tool Description Location - Where to define MCP tool descriptions: in @mcp.tool() functions in __init__.py, not in *_TOOLS arrays

Python Code Verification

• Import Validation - Use actual module imports (python -c "from ... import ...") instead of py_compile to catch missing imports