项目简介:

Meraki Magic MCP是一个Python实现的Model Context Protocol (MCP) 服务器，专门用于集成Cisco Meraki Dashboard API。它允许通过符合MCP标准的客户端（如支持MCP的LLM应用）来访问和操作Meraki网络环境，将Meraki的功能暴露为LLM可调用的工具。

主要功能点:

• 网络管理: 支持创建、删除和获取Meraki组织下的网络列表。
• 设备和客户端发现: 提供获取组织内设备列表、获取特定网络下客户端列表、获取客户端策略等功能。
• 设备操作: 支持将设备添加到网络（claim）以及更新设备的配置信息。
• 上下文资源: 定义简单的文本资源，例如一个动态问候语。
• 标准协议: 通过MCP协议与客户端通信，提供结构化的数据访问和工具调用接口。

安装步骤:

1. 克隆仓库:

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

2. 创建并激活虚拟环境:

   python -m venv .venv
   source .venv/bin/activate  # Windows 系统使用: .venv\Scripts\activate
   

3. 安装依赖:

   pip install -r requirements.txt
   

服务器配置:

Meraki Magic MCP 需要您的 Meraki API 密钥和组织 ID。

1. 复制示例配置文件：

   cp .env-example .env
   

2. 编辑 '.env' 文件，填入您的 Meraki API 密钥和组织 ID：

   MERAKI_API_KEY="您的Meraki API Key"
   MERAKI_ORG_ID="您的Meraki Organization ID"
   

3. 客户端配置: 此服务器通过命令行启动，并与支持MCP的客户端（如某些LLM桌面客户端）通信。客户端通常需要配置服务器的启动命令和参数。请参考您的客户端文档，配置指向 Meraki Magic MCP 的启动命令。 typically 配置如下信息 (请将路径替换为您本地的实际路径):
   • command: 指向项目虚拟环境中 'fastmcp' 可执行文件的完整路径 (例如 '/path/to/meraki-magic-mcp/.venv/bin/fastmcp')。
   • args: 包含启动参数的列表，通常是 '["run", "/path/to/meraki-magic-mcp/meraki-mcp.py"]'，其中 '/path/to/meraki-magic-mcp/meraki-mcp.py' 是服务器主脚本的完整路径。

基本使用方法:

1. 按照上述步骤完成安装和配置，确保 '.env' 文件中填入了正确的 Meraki API 凭据。
2. 配置您的 MCP 客户端（如支持 MCP 的 LLM 客户端），使其能够启动 Meraki Magic MCP 服务器。
3. 启动或重启您的 MCP 客户端。客户端将自动发现并连接到 Meraki Magic MCP 服务器，获取其提供的工具和资源列表。
4. 通过与客户端中的 LLM 进行自然语言交互，您可以请求 LLM 调用 Meraki Magic MCP 提供的工具来执行 Meraki 相关的操作，例如查询网络信息、设备状态或客户端列表。