🚀 mcp-netmiko-server

mcp-netmiko-server 是一个 MCP 服务器，它能让大语言模型借助 SSH（netmiko）与您的网络设备进行交互，为网络设备管理提供了便捷的途径。

🚀 快速开始

📦 安装指南

git clone https://github.com/upa/mcp-netmiko-server
cd mcp-netmiko-server

# 创建设备列表文件
vim my-devices.network.toml

# 通过标准输入输出运行
uv run --with "mcp[cli]" --with netmiko main.py my-devices.network.toml

# 以 SSE 服务器模式运行：URL 为 http://localhost:10000/sse
uv run --with "mcp[cli]" --with netmiko main.py my-devices.network.toml --sse

⚙️ 配置说明

在网络设备列表文件中定义您的网络设备，例如 sample.network.toml：

[default]

username = "rouser"
password = "rouserpassword"

[qfx1]

hostname = "172.16.0.40"
device_type = "juniper_junos"

[nexus1]

hostname = "nexus1.lab"
device_type = "cisco_nxos"

[default] 是一个特殊部分，定义默认值，如 username 和 password。设备会继承这些默认值，如果它们的配置中没有定义。

对于 device_type 值，请参见 netmiko 支持的平台。

📝 claude 桌面配置 json

{
  "mcpServers": {
    "netmiko server": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "--with",
        "netmiko",
        "[PATH TO]/mcp-netmiko-server/main.py",
        "[PATH TO]/YOUR-DEVICE.toml"
      ]
    }
  }
}

💡 使用建议

• 在创建设备列表文件时，请确保文件路径和文件名的正确性，避免因文件找不到而导致程序运行失败。
• 对于 device_type 的设置，请务必参考 netmiko 支持的平台，以确保设备类型配置正确。
• 在配置 claude 桌面时，请将 [PATH TO] 替换为实际的文件路径。