Meraki Magic MCP

Meraki Magic és un servidor MCP (Model Context Protocol) basat en Python per al Dashboard de Meraki de Cisco. Meraki Magic ofereix eines per consultar l'API del Dashboard de Meraki per descobrir, monitorar i gestionar el vostre entorn Meraki.

Característiques

• Gestió de Xarxa Integral: Descoberta, monitorització i gestió completa de la xarxa
• Gestió Avançada de Dispositius: Provisió, monitorització i eines en temps real
• Gestió Inal·lat: Gestió completa de SSID i perfils RF
• Gestió de Switch: Gestió de ports, configuració de VLAN i regles QoS
• Gestió d'Appliance: VPN, tallafoc, filtratge de contingut i seguretat
• Gestió de Camara: Analítica, instantànies i configuració de sense
• Automatització de Xarxa: Lotes d'accions i operacions en massa
• Eines de Dispositiu en Temps Real: Ping, prova de cable, control d'LED i wake-on-LAN
• Monitorització Avançada: Esdeveniments, alertes i analítica de rendiment

Instal·lació

• Clona el repositori:

git clone https://github.com/mkutka/meraki-magic.git
cd meraki-magic-mcp

• Crea i activa un entorn virtual:

python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

• Instal·la les dependències:

pip install -r requirements.txt

Configuració

• Copia el fitxer d'exemple d'entorn:

cp .env-example .env

• Actualitza el fitxer .env amb la teva clau d'API i ID d'organització:

MERAKI_API_KEY="Meraki API Key here"
MERAKI_ORG_ID="Meraki Org ID here"

Ús amb el Client d'Escriptori Claude

Configuració del Client d'Escriptori Claude per utilitzar aquest servidor MCP

• Obre el Client d'Escriptori Claude.
• Ves a Settings > Developer > Edit Config.
• Afegeix el fitxer de configuració següent: claude_desktop_config.json

{
  "mcpServers": {
      "Meraki_Magic_MCP": {
        "command": "/Users/mkutka/meraki-magic-mcp/.venv/bin/fastmcp",
        "args": [
          "run",
          "/Users/mkutka/meraki-magic-mcp/meraki-mcp.py"
        ]
      }
  }
}

• Substitueix els camins per reflectir el teu entorn local.
• Reinicia el Client d'Escriptori Claude.
• Interactua amb el Client d'Escriptori Claude.

Guia d'Eines de Xarxa

Aquesta guia ofereix una visió completa de totes les eines de xarxa disponibles en Meraki Magic MCP, organitzades per categoria i funcionalitat.

Taula de Continguts

• Eines de Gestió d'Organització
• Eines de Gestió de Xarxa
• Eines de Gestió de Dispositius
• Eines de Gestió Inal·lat
• Eines de Gestió de Switch
• Eines de Gestió d'Appliance
• Eines de Gestió de Camara
• Eines d'Automatització de Xarxa
• Eines de Monitorització Avançada
• Eines de Dispositiu en Temps Real

Eines de Gestió d'Organització

Operacions Bàsiques d'Organització

• get_organizations() - Obtén una llista d'organitzacions a les quals l'usuari té accés
• get_organization_details(org_id) - Obtén detalls d'una organització específica
• get_organization_status(org_id) - Obtén l'estat i la salut d'una organització
• get_organization_inventory(org_id) - Obtén l'inventari d'una organització
• get_organization_license(org_id) - Obtén l'estat de la llicència d'una organització
• get_organization_conf_change(org_id) - Obtén l'estat de canvi de configuració de l'organització

Gestió Avançada d'Organització

• get_organization_admins(org_id) - Obtén els administradors d'una organització
• get_organization_admins(org_id) - Obtén els administradors d'una organització
• get_organization_admins(org_id) - Obtén els administradors d'una organització
• get_organization_admins(org_id) - Obtén els administradors d'una organització

Eines de Gestió de Xarxa

Operacions Bàsiques de Xarxa

• get_networks(org_id) - Obtén una llista de xarxes d'una organització
• get_network_details(network_id) - Obtén detalls d'una xarxa específica
• get_network_status(network_id) - Obtén l'estat i la salut d'una xarxa
• get_network_inventory(network_id) - Obtén l'inventari d'una xarxa
• get_network_license(network_id) - Obtén l'estat de la llicència d'una xarxa
• get_network_conf_change(network_id) - Obtén l'estat de canvi de configuració d'una xarxa

Gestió Avançada de Xarxa

• get_network_admins(network_id) - Obtén els administradors d'una xarxa
• get_network_admins(network_id) - Obtén els administradors d'una xarxa
• get_network_admins(network_id) - Obtén els administradors d'una xarxa
• get_network_admins(network_id) - Obtén els administradors d'una xarxa

Eines de Gestió de Dispositius

Operacions Bàsiques de Dispositiu

• get_devices(org_id) - Obtén una llista de dispositius d'una organització
• get_device_details(device_id) - Obtén detalls d'un dispositiu específic
• get_device_status(device_id) - Obtén l'estat i la salut d'un dispositiu
• get_device_inventory(device_id) - Obtén l'inventari d'un dispositiu
• get_device_license(device_id) - Obtén l'estat de la llicència d'un dispositiu
• get_device_conf_change(device_id) - Obtén l'estat de canvi de configuració d'un dispositiu

Gestió Avançada de Dispositius

• get_device_admins(device_id) - Obtén els administradors d'un dispositiu
• get_device_admins(device_id) - Obtén els administradors d'un dispositiu
• get_device_admins(device_id) - Obtén els administradors d'un dispositiu
• get_device_admins(device_id) - Obtén els administradors d'un dispositiu

Eines de Gestió Inal·lat

Operacions Bàsiques d'Inal·lat

• get_wireless_networks(org_id) - Obtén una llista de xarxes inal·lades d'una organització
• get_wireless_network_details(network_id) - Obtén detalls d'una xarxa inal·lada específica
• get_wireless_network_status(network_id) - Obtén l'estat i la salut d'una xarxa inal·lada
• get_wireless_network_inventory(network_id) - Obtén l'inventari d'una xarxa inal·lada
• get_wireless_network_license(network_id) - Obtén l'estat de la llicència d'una xarxa inal·lada
• get_wireless_network_conf_change(network_id) - Obtén l'estat de canvi de configuració d'una xarxa inal·lada

Gestió Avançada d'Inal·lat

• get_wireless_network_admins(network_id) - Obtén els administradors d'una xarxa inal·lada
• get_wireless_network_admins(network_id) - Obtén els administradors d'una xarxa inal·lada
• get_wireless_network_admins(network_id) - Obtén els administradors d'una xarxa inal·lada
• get_wireless_network_admins(network_id) - Obtén els administradors d'una xarxa inal·lada

E