YueGuobin 012df5af57
docs: add simplified MCP tool description guide to project memory
Added a focused, concise memory document about MCP tool description
location. Simplified from 180 lines to 45 lines to capture only the
essential information needed for future conversations.

Key points documented:
- MCP tool descriptions are defined in @mcp.tool() functions in __init__.py
- NOT in *_TOOLS arrays in individual module files
- Must restart GNS3 server to see description updates
- Description requirements: explicit formats, ranges, and examples

This replaces the verbose 180-line version with a practical 45-line
guide focused on answering: 'Where should I write tool descriptions so
the AI can see them?'
2026-06-07 00:32:39 +08:00

1.9 KiB

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

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

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