ciscodevnet/meraki-magic-mcp-community

マーキ・マジック MCP

Meraki Magic は、Cisco の Meraki Dashboard 用の Python ベースの MCP (Model Context Protocol) サーバーです。 Meraki Magic は、Meraki Dashboard API をクエリして、Meraki の環境を発見、監視、管理するためのツールを提供しています。

利用できる2つの版

ロッジ ダイナミック MCP (推奨) - [meraki-mcp-dynamic.py]

• ~804 APIのエンドポイント自動的に露出される -100% SDKカバレッジ - 利用可能なすべてのMeraki APIメソッド
• Meraki SDKのアップグレード時に自動更新** -新しいエンドポイントに必要な手動コーディングなし

マニュアル MCP** - [[T1]

• *40のキュレーションされたエンドポイント**詳細なスキーマ
• Pydantic検証とType-safe
• 特定のユースケースのためのカスタムビジネスロジック -共通操作のためのクリーンドキュメント

##特徴

ダイナミックMCP:

• すべての組織管理(管理者、ネットワーク、デバイス、在庫、ライセンス)
• 完全な無線管理(SSID、RFのプロフィール、空気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"