使用说明
思科Nexus仪表板的MCP服务器
此存储库为Cisco Nexus Dashboard工作流提供Python MCP服务器:
ciscoNDServer在app/main.py用于异常、咨询、库存和政策阅读。ndfcServer在app_ndfc/main.py用于NDFC意图读取、预览和受控补救工作流。nxosFabricServer在app_nxos/main.py用于交换机上的直接NX-API验证。
服务器以STDIO模式运行,专为与VS Code Copilot Chat(代理模式)或其他MCP客户端本地使用而设计。
安全和公共报告准备就绪
此存储库已针对公共共享进行了清理:
- 真实密码和用户名被占位符取代。
- 管理IP地址和交换机序列被替换为示例值。
- 用户特定的绝对文件系统路径已从实用程序脚本中删除。
在发布自己的fork之前,运行以下清单:
- 确保跟踪文件中不存在真正的秘密。
- 保持本地
.envgit忽略的文件(已在中配置.gitignore). - 在示例中使用占位符(
<ND_HOST_OR_FQDN>,<ND_PASSWORD>等等)。 - 确认
.vscode/mcp.json未提交(已被忽略)。
先决条件
- Python 3.11+(或与项目依赖项兼容)。
- 可选但推荐: 紫外线.
- 访问思科Nexus仪表板和NX-OS设备(可选)。
快速开始
-
创建并激活虚拟环境:
python -m venv .venv source .venv/bin/activate -
为您计划运行的每台服务器安装依赖关系:
pip install -r app/requirements.txt pip install -r app_ndfc/requirements.txt pip install -r app_nxos/requirements.txt -
使用您自己的值配置环境文件:
app/.envapp_ndfc/.envapp_nxos/.env
-
通过客户端配置启动一个或多个MCP服务器(例如在VS代码中
.vscode/mcp.json).
环境变量
ciscoNDServer(app/.env)
ND_HOST=<ND_HOST_OR_FQDN>
ND_USERNAME=<ND_USERNAME>
ND_PASSWORD=<ND_PASSWORD>
ND_DOMAIN=<ND_DOMAIN>
ndfc服务器(app_ndfc/.env)
ND_HOST=<ND_HOST_OR_FQDN>
ND_USERNAME=<ND_USERNAME>
ND_PASSWORD=<ND_PASSWORD>
ND_DOMAIN=<ND_DOMAIN>
nxosFabricServerapp_nxos/.env)
NXOS_INVENTORY=app_nxos/inventory.yaml
NXOS_DEFAULT_USERNAME=<NXOS_USERNAME>
NXOS_DEFAULT_PASSWORD=<NXOS_PASSWORD>
NXOS_VERIFY_TLS=false
库存文件
NX-OS库存 app_nxos/inventory.yaml 有意作为具有不可路由文档IP范围的示例数据集(192.0.2.0/24, 198.51.100.0/24).
将这些值替换为您自己的设备管理终结点。
示例提示
- “给我ND上标记的织物的名称”
- “收集结构VXLAN2上的所有活动异常”
- “显示结构VXLAN2的合规性摘要”
- “预览VXLAN2中叶子交换机的挂起配置”
