ciscodevnet/meraki-magic-mcp-community

Магия Мераки MCP

Meraki Magic - это MCP-сервер на базе Python (Model Context Protocol) для панели управления Cisco Meraki. Meraki Magic предоставляет инструменты для запроса API панели инструментов Meraki для обнаружения, мониторинга и управления средой Meraki.

Доступны две версии

** Динамический MCP (рекомендуется)** - meraki-mcp-dynamic.py ~804 конечных точек API автоматически 100% охват SDK - все доступные методы API Meraki Автообновления при обновлении Meraki SDK ** Для новых конечных точек не требуется ручного кодирования**

** Ручной MCP** — meraki-mcp.py 40 курируемых конечных точек с подробными схемами ** Безопасный тип** с валидацией Pydantic Таможенная бизнес-логика для конкретных случаев использования Чистая документация для общих операций

Особенности

** Динамический MCP включает в себя: **

• Все управление организацией (администраторы, сети, устройства, инвентарь, лицензирование) Полное управление беспроводной связью (SSID, профили РФ, Air Marshal, аналитика) Полное управление переключателями (порты, VLAN, стеки, QoS, политики доступа)
• Продвинутый прибор / безопасность (все типы брандмауэров, NAT, VPN, формирование трафика)
• Управление камерой (аналитика, качество, расписание, разрешения)

Meraki Magic MCP

Meraki Magic is a Python-based MCP (Model Context Protocol) server for Cisco’s Meraki Dashboard. Meraki Magic provides tools for querying the Meraki Dashboard API to discover, monitor, and manage your Meraki environment.

Two Versions Available

🚀 Dynamic MCP (Recommended) - meraki-mcp-dynamic.py

• ~804 API endpoints automatically exposed
• 100% SDK coverage - all Meraki API methods available
• Auto-updates when you upgrade the Meraki SDK
• No manual coding required for new endpoints

📋 Manual MCP - meraki-mcp.py

• 40 curated endpoints with detailed schemas
• Type-safe with Pydantic validation
• Custom business logic for specific use cases
• Clean documentation for common operations

Features

Dynamic MCP includes:

• All organization management (admins, networks, devices, inventory, licensing)
• Complete wireless management (SSIDs, RF profiles, Air Marshal, analytics)
• Full switch management (ports, VLANs, stacks, QoS, access policies)
• Advanced appliance/security (all firewall types, NAT, VPN, traffic shaping)
• Camera management (analytics, quality, schedules, permissions)
• Network monitoring (events, alerts, health, performance)
• Live troubleshooting tools (ping, cable test, ARP table)
• Webhooks and automation (alert profiles, action batches)
• And 700+ more endpoints…

Manual MCP includes:

• Network discovery and management
• Device discovery and configuration
• Client discovery and policy management
• Wireless SSID management
• Switch port and VLAN configuration
• Basic firewall rules
• Camera settings

Quick Installation

Prerequisites

• Python 3.13+
• Claude Desktop (or any MCP-compatible client)
• Meraki Dashboard API Key
• Meraki Organization ID

Fast Track

macOS:

git clone https://github.com/CiscoDevNet/meraki-magic-mcp-community.git
cd meraki-magic-mcp-community
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
# Set credentials in the MCP client env block (see Configuration)

Windows (PowerShell):

git clone https://github.com/CiscoDevNet/meraki-magic-mcp-community.git
cd meraki-magic-mcp-community
python -m venv .venv
.venv\Scripts\Activate.ps1
pip install -r requirements.txt
# Set credentials in the MCP client env block (see Configuration)

📖 For detailed step-by-step instructions, see INSTALL.md

Configuration

The server reads credentials from the process environment. Do not create a project .env file.

For Claude Desktop / Cursor (stdio), put them in the client config env block:

"env": {
  "MERAKI_API_KEY": "your_api_key_here",
  "MERAKI_ORG_ID": "your_org_id_here",
  "MERAKI_BASE_URL": "https://api.meraki.com/api/v1",
  "MERAKI_PYTHON_SDK_CALLER": "MagicMCP CiscoDevNet",
  "READ_ONLY_MODE": "true"
}

For CLI, HTTP, or Docker, export the same variables in your shell:

export MERAKI_API_KEY="your_api_key_here"