cisco-pt-mcp 🚀

Автоматизация Cisco Packet Tracer на базе ИИ — Позвольте ИИ-клиентам управлять Packet Tracer с помощью естественного языка. Открытый MCP-сервер с интеграцией Gemini AI.

✨ Возможности

• 🤖 ИИ-генерация сетей — Описывайте сети на простом английском и получайте рабочие топологии

• 🎨 Визуальный интерфейс построения — Веб-редактор кода с подсветкой синтаксиса

• 📦 Готовые шаблоны — конфигурации для кампуса, филиала, VLAN и маршрутизации

• 🔌 Протокол MCP — Работает с Claude Desktop, Cursor и другими MCP-клиентами

• ⚡ Управление в реальном времени — Прямой мост к запущенному экземпляру Packet Tracer

• 🛠️ Полный набор инструментов — 20+ инструментов для управления устройствами, настройки и тестирования

Related MCP server: packet-tracer-mcp

📥 Быстрая установка

1. Установите MCP-сервер

# Clone or download this repository
cd cisco-pt-mcp

# Install with AI support
pip install -e ".[ai]"

# Configure Gemini API (optional, for AI features)
python setup_config.py

2. Установите расширение Packet Tracer

1. Откройте Cisco Packet Tracer

2. Extensions → Scripting → Configure PT Script Modules

3. Нажмите Add → выберите extension/cisco-pt-mcp.pts

4. Перезапустите Packet Tracer

3. Запуск и подключение

# Start the MCP server
python -m mcp_server

В Packet Траге:

• Нажмите Extensions → Packet Tracer MCP

• В статусе должно появиться «MCP Connected»

📖 Подробную инструкцию см. в QUICKSTART.md

🎯 Режимы использования

Режим 1: ИИ-генератор (естественный язык)

Откройте интерфейс PTBuilder в Packet Tracer и используйте вкладку AI Generator:

"Create a corporate network with 1 edge router, 1 core switch, 
2 department switches, and 3 PCs per department. Configure VLANs."

Нажмите Generate — сеть появится в рабочей области!

Режим 2: Редактор кода (JavaScript)

Пишите код PTBuilder напрямую:

addDevice("R1", "2911", 150, 150);
addDevice("S1", "2960-24TT", 350, 150);
addLink("R1", "GigabitEthernet0/0", "S1", "GigabitEthernet0/1", "straight");
configureIosDevice("R1", "interface Gi0/0\nip address 192.168.1.1 255.255.255.0");

Режим 3: MCP-клиент (Claude/Cursor)

Настройте ваш MCP-клиент:

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "cisco-pt-mcp": {
      "command": "python",
      "args": ["-m", "mcp_server"],
      "cwd": "/path/to/cisco-pt-mcp",
      "env": {
        "GEMINI_API_KEY": "your_key_here"
      }
    }
  }
}

Затем напишите Claude:

«Создай сетевую лабораторную для тестирования маршрутизации OSPF с 3 маршрутизаторами»

🛠️ Доступные инструменты

Инструменты на основе ИИ

Основные сетевые инструменты

Инструменты настройки

Инструменты мониторинга и симуляции

📚 Документация

• QUICKSTART.md — Запуск за 5 минут

• SETUP_GUIDE.md — Полное руководство по установке и использованию

• packet-tracer-automation-build-doc.md — Продвинутые техники автоматизации

🎓 Примеры

Пример 1: Простая сеть с помощью ИИ

Prompt: "Create a basic network with one 2911 router, one 2960 switch, 
and two PCs. Configure the router with IP 192.168.1.1 and the PCs 
with static IPs in the same subnet."

Result: Complete working network in 30 seconds

Пример 2: Шаблон кампусной сети

Загрузите шаблон «Campus Network» со вкладки Templates:

• Трёхуровневая архитектура (ядро, распределение, доступ)

• 1 коммутатор ядра

• 2 коммутатора распределения

• 4 коммутатора доступа

• Правильные соединения между коммутаторами

Пример 3: Настройка VLAN

// From templates - VLAN setup
addDevice("S1", "2960-24TT", 300, 200);
addDevice("PC1", "PC-PT", 150, 300);
addDevice("PC2", "PC-PT", 450, 300);

configureIosDevice("S1", `
vlan 10
name Sales
vlan 20
name Engineering

interface FastEthernet0/1
switchport mode access
switchport access vlan 10

interface FastEthernet0/2
switchport mode access
switchport access vlan 20
`);

🔧 Конфигурация

Настройка Gemini API

Вариант 1: Интерактивный

python setup_config.py

Вариант 2: Переменная окружения

export GEMINI_API_KEY="your_key_here"

Вариант 3: Файл конфигурации Создайте ~/.cisco-pt-mcp/config.json:

{
  "gemini_api_key": "YOUR_KEY_HERE",
  "bridge_host": "127.0.0.1",
  "bridge_port": 7531,
  "tool_timeout": 60
}

🏗️ Архитектура

┌─────────────────┐
│   MCP Client    │  (Claude Desktop, Cursor, etc.)
│  (Natural Lang) │
└────────┬────────┘
         │ MCP Protocol
┌────────▼────────┐
│   MCP Server    │  (Python)
│   + Gemini AI   │  - Network generation
│                 │  - Code generation
└────────┬────────┘
         │ Socket.IO (port 7531)
┌────────▼────────┐
│ PT Extension    │  (JavaScript)
│  cisco-pt-mcp   │  - PTBuilder integration
│                 │  - Web interface
└────────┬────────┘
         │ IPC API
┌────────▼────────┐
│ Packet Tracer   │  (Cisco Application)
│   Workspace     │
└─────────────────┘

🤝 Участие в разработке

Вклад приветствуется! Проект объединяет:

• Model Context Protocol (MCP)

• PTBuilder — JavaScript-автоматизация для PT

• Gemini API — генерация сетей на основе ИИ

📄 Лицензия

MIT License — см. файл LICENSE

🙏 Благодарности

• PTBuilder от kimmknight — фреймворк JavaScript-автоматизации

• MCP Protocol — стандарт для взаимодействия ИИ-приложений

• Google Gemini — возможности ИИ-генерации

• Оригинальный cisco-pt-mcp от muhammadbalawal

🆘 Поддержка и проблемы

• Устранение неполадок: см. SETUP_GUIDE.md

• Проблемы: откройте issue на GitHub

• Документация: загляните в папку docs

Поставьте ⭐ этому репозиторию, если находите его полезным!