Nmstate MCP

🚀 Nmstate MCP

Nmstate MCP 是一個藉助 nmstate 應用網絡配置的 MCP 服務器。其願景是藉助大語言模型（LLMs）和 MCP 的強大能力，讓網絡管理變得更加輕鬆。歡迎提交包含想法的問題反饋哦！當前代碼僅為原型，後續可能需要更周全地重新編寫。

🚀 快速開始

✨ 前置條件

• npm（可選：用於 MCP-Superassistant）
• python3
• uv
• python3-libnmstate

📦 安裝指南

從 DNF Copr 安裝

以下是通過 dnf 包管理器設置和運行項目的說明：

1. 從 Copr 倉庫安裝

sudo dnf copr enable rrajesh/nmstate-mcp
sudo dnf install nmstate-mcp

2. 運行設置腳本

nmstate-mcp-setup

目前，此腳本對應 setup_cursor.py，且當前僅支持 Cursor IDE。 3. 設置 inventory.yaml 設置 ~/.nmstate-mcp/inventory.yaml，以包含你想要配置的遠程主機。nmstate-mcp 使用 Ansible 進行遠程主機配置。

從源碼安裝

以下是從源碼設置和運行項目的說明：

1. 安裝 libnmstate

sudo dnf install python3-libnmstate uv

2. 創建使用系統站點包的虛擬環境以使用 libnmstate

uv venv --system-site-packages .venv

source .venv/bin/activate

3. 下載依賴項

uv sync

4. 運行服務器的命令

uv run --directory <項目目錄路徑> main.py

或者，如果你已經在項目目錄中：

uv run main.py

使用此命令時，你無需手動激活 Python 虛擬環境。

💻 使用示例

配置 MCP 客戶端

Claude Desktop 和 Cursor 以及其他可能的客戶端支持這種 "mcpServers" 格式：

{
  "mcpServers": {
    "nmstate-mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "<你的項目路徑>",
        "main.py"
      ]
    },
  }
}

對於 MCP SuperAssistant：運行代理服務器

這也將運行 nmstate mcp 服務器實現。請查看 mcpconfig.json，並根據你的目錄設置進行編輯。 UV 運行文檔：docs.astral.sh/uv/reference/cli/#uv-run

npx @srbhptl39/mcp-superassistant-proxy@latest --config ./mcpconfig.json

🔧 遠程主機配置

前置條件

• Ansible
• SSH
• 為了演示目的，你可以在虛擬機中設置無密碼 sudo，或者想出其他認證方式。因為無法通過 Cursor 獲取密碼提示。