Cisco NX-OS CLI MCP Server

MCP开发工具

提供方 sdntechforum · 包名 @modelcontextprotocol/inspector

开发工具 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude DesktopClaudeClineVS Code
查看接入方式

一个用于与Cisco NX-OS设备交互的模型上下文协议(MCP)服务器,支持通过NX-API接口向一个或多个交换机发送任意CLI命令,并提供全面的错误处理和多种输出格式选择。

一句话选型结论

按资料字段整理

Cisco NX-OS CLI MCP Server 属于开发工具类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude Desktop、Claude、Cline 等,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 2 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量2暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

网络管理Python本地部署CLI工具设备控制批量操作自动化

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
npx @modelcontextprotocol/inspector uv run nxos_cli_mcp.py

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 2 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 2 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude Desktop、Claude、Cline,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Cisco NX-OS CLI MCP Server当前 2 stdio · 本地进程 本地部署 有 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方sdntechforum上游标注的维护方 sdntechforum
分类开发工具本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时@modelcontextprotocol/inspector · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

8.1 KB
来自项目仓库与上游目录的原文,未做删改

思科NX-OS CLI MCP服务器

一个模型上下文协议(MCP)服务器,允许您与Cisco NX-OS设备进行交互。您可以通过NX-API接口向一个或多个交换机发送任意CLI命令。
此服务器公开了MCP工具,用于在一个或多个设备上执行命令,并具有全面的错误处理功能。也可以选择输出格式(文本或JSON)。

特性

  • 单设备命令:在单个NX-OS交换机上执行CLI命令
  • 多设备命令:在多个交换机上同时执行相同的命令
  • 基于文本的I/O:命令以文本形式发送(cli_show_ascii),响应默认为文本格式
  • JSON选项:用于结构化解析的可选JSON响应格式
  • 简单身份验证:从.env文件或按请求覆盖收集的凭据
  • 错误处理:清晰、可操作的错误消息
  • 批量操作:每个请求最多执行100个命令
  • 并发执行:在多个设备上并行执行命令(最多50个)

需求

  • Python 3.10或更高版本
  • 启用NX-API的Cisco NX-OS设备(feature nxapi)
  • MCP主机(Claude Desktop等)通过HTTPS与目标设备之间的网络连接

安装

先决条件

  • Python 3.10或更高版本
  • 紫外线 -快速Python包安装程序(推荐)
  • 启用NX-API的Cisco NX-OS设备(feature nxapi)
  • 通过HTTPS连接到目标设备的网络

设置

  1. 安装uv(如果尚未安装):```bash

macOS/Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"


2. 使用uv安装依赖项:```bash
# With uv and pyproject.toml (recommended)
uv sync
  1. 设置身份验证凭据:

创建一个 .env 模板中的文件:```bash
cp .env.example .env


编辑 `.env` 并添加您的凭据:```env
NXOS_USERNAME=admin
NXOS_PASSWORD=your_secure_password

重要:永远不要承诺你的生产 .env 文件到版本控制。 .gitignore 配置为防止这种情况,但要小心!

向MCP主机注册

克劳德桌面版

macOS:

编辑Claude Desktop配置文件:```bash
code ~/Library/Application\ Support/Claude/claude_desktop_config.json


将NX-OS CLI MCP服务器添加到 `mcpServers` 章节:```json
{
"mcpServers": {
"nxos-cli": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/nxos-cli-mcp",
"run",
"nxos_cli_mcp.py"
]
}
}
}

窗户:

编辑Claude Desktop配置文件:```powershell
notepad %APPDATA%\Claude\claude_desktop_config.json


将NX-OS CLI MCP服务器添加到 `mcpServers` 章节:```json
{
"mcpServers": {
"nxos-cli": {
"command": "uv",
"args": [
"--directory",
"C:\\absolute\\path\\to\\nxos-cli-mcp",
"run",
"nxos_cli_mcp.py"
]
}
}
}

保存后,重新启动Claude Desktop以使更改生效。

Visual Studio Code

macOS:

编辑VS Code MCP设置文件:```bash
code ~/Library/Application\ Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json


添加服务器配置:```json
{
"mcpServers": {
"nxos-cli": {
"command": "uv",
"args": [
"--directory",
"/absolute/path/to/nxos-cli-mcp",
"run",
"nxos_cli_mcp.py"
]
}
}
}

窗户:

编辑VS Code MCP设置文件:```powershell
notepad %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\cline_mcp_settings.json


添加服务器配置:```json
{
"mcpServers": {
"nxos-cli": {
"command": "uv",
"args": [
"--directory",
"C:\\absolute\\path\\to\\nxos-cli-mcp",
"run",
"nxos_cli_mcp.py"
]
}
}
}

保存后,重新加载VS代码窗口(命令/Ctrl+Shift+P→ “开发人员:重新加载窗口”)。

重要提示:

  • 替换 /absolute/path/to/nxos-cli-mcp (或 C:\absolute\path\to\nxos-cli-mcp)包含项目目录的实际完整路径
  • 确保 .env 包含您的凭据的文件位于项目目录中
  • 服务器将自动从以下位置加载凭据 .env MCP客户端启动文件时

可用工具

1.nxos_execute_命令

在单个NX-OS设备上执行CLI命令。

参数:

  • ip_address (必填):设备的IP地址或主机名
  • commands (必需):要执行的CLI命令列表
  • response_format (可选):“text”(默认,人类可读)或“json”(结构化数据)
  • username (可选):用于身份验证的用户名
  • password (可选):身份验证密码
  • timeout (可选):请求超时时间(秒)(默认值:30)

2.nxosexecute_commands_multi

在多个NX-OS设备上同时执行相同的CLI命令。

参数:

  • ip_addresses (必填):设备IP地址或主机名列表(最多50个)
  • commands (必需):要在所有设备上执行的CLI命令列表
  • response_format (可选):“text”(默认,人类可读)或“json”(结构化数据)
  • username (可选):用于身份验证的用户名
  • password (可选):身份验证密码
  • timeout (可选):每个设备请求超时秒数(默认值:30)
  • continue_on_error (可选):如果一个设备失败,则继续在其他设备上执行(默认值:true)

NX-API配置

在使用此MCP服务器之前,请确保NX-OS设备上已启用NX-API:```
configure terminal
feature nxapi
nxapi http port 80
nxapi https port 443


验证NX-API是否正在运行:```
show nxapi

安全注意事项

  1. 凭证:将凭据存储在 .env file,永远不要将文件提交到版本控制
  2. 文件权限:确保 .env 具有受限权限(chmod 600 .env 在Unix系统上)
  3. 超文本传输安全协议:此MCP服务器与NX-API进行HTTPS通信(对自签名证书禁用验证;针对生产更改此项!)

输出格式

命令是如何发送的

所有命令均以如下方式发送到NX-OS设备 文本 使用 cli_show_ascii API类型。这可确保与您熟悉的CLI体验保持一致的行为。

响应格式

  • 文本 (默认):纯文本输出,与您在CLI会话中看到的相同

  • 易于在Claude Desktop或VS Code中阅读

  • 保留设备的格式
  • 最适合交互式使用

  • JSON:具有详细元数据的结构化JSON响应,可能更适合MCP主机(实验)

  • 包括每个设备的成功/失败状态

  • 命令执行结果
  • 适用时的错误详细信息
  • 适用于程序化解析或复杂的工作流程

错误处理

服务器为常见场景提供详细的错误消息:

  • 身份验证失败:“身份验证失败。请检查用户名和密码。”
  • 权限不足:“权限被拒绝。用户可能没有足够的权限。”
  • 未找到NX-API:“未找到NX-API终结点。请验证设备是否支持NX-API。”
  • 超时:“请求在X秒后超时”
  • 命令错误:包括来自NX-OS的命令特定错误代码和消息

局限性

  • 每次多设备命令执行最多50个设备
  • 每个请求最多100个命令
  • 超时范围:1-300秒
  • SSL证书验证已禁用(假定为自签名证书),请在生产中更改此设置!

故障排除

连接被拒绝

  • 验证NX-API是否已在设备上启用: show nxapi
  • 检查网络连接: ping
  • 验证HTTPS端口是否可访问(默认值:443)

认证失败

  • 验证中的凭据 .env 文件正确
  • 检查 .env 文件存在于项目根目录中
  • 确保 .env 文件格式正确(周围没有空格 =)
  • 验证设备上是否存在用户帐户
  • 通过SSH向设备测试证书

命令执行错误

  • 验证NX-OS的命令语法是否正确
  • 检查用户是否有足够的权限执行该命令
  • 查看NX-OS命令输出以了解具体的错误详细信息

超时问题

  • 增加慢速命令的超时参数
  • 检查设备的网络延迟
  • 考虑拆分大型命令批

测试

使用MCP检查器运行```bash

npx @modelcontextprotocol/inspector uv run nxos_cli_mcp.py
```

许可证

此MCP服务器是根据MIT许可证按原样提供的。

贡献

欢迎投稿!请确保:

  • 代码遵循现有的模式和约定
  • 所有函数都有全面的文档字符串
  • 输入验证由Pydantic模型处理
  • 错误信息清晰且可操作

支持

关于以下问题:

  • NX-API公司:查阅思科NX-OS文档
  • MCP协议:参观https://modelcontextprotocol.io
  • 此服务器:查看错误消息和故障排除部分

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Cisco NX-OS CLI MCP Server 怎么安装?

在客户端按下面的安装命令接入:npx @modelcontextprotocol/inspector uv run nxos_cli_mcp.py。对应的包名是 @modelcontextprotocol/inspector。装完在客户端配置里引用同一个包或端点。

Cisco NX-OS CLI MCP Server 怎么在 Claude Desktop、Claude、Cline 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Cisco NX-OS CLI MCP Server 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Cisco NX-OS CLI MCP Server 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Cisco NX-OS CLI MCP Server 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cline、VS Code;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Cisco NX-OS CLI MCP Server 能提供哪些能力?

资料显示约 2 个工具;能力标签包括 网络管理、命令行工具、Python、Claude、批量操作。具体工具清单以官方文档为准。

Cisco NX-OS CLI MCP Server 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

Cisco NX-OS CLI MCP Server 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。