安裝
git clone https://github.com/alpadalar/netops-mcp.git
cd netops-mcp
uv venv
source .venv/bin/activate
uv pip install -e .適合誰
如果你要把 ping、traceroute、mtr、nmap、DNS、HTTP 和系統監控接到 MCP 用戶端,這個服務對得上。官方把它寫成暴露 26 個網路與系統診斷工具的伺服器,並點名 Claude Desktop、Claude Code 和 Cursor。
協議說明:
https://modelcontextprotocol.io/
適合已經能複製倉庫、使用 uv,並且執行 Linux 或 macOS 的人。官方要求 Python 3.10 或更新;網路工具與作業系統相關,不支援 Windows。
它不適合在 Windows 上尋找替代路徑的人,也不適合第一次就對公網目標做 nmap 掃描的人。掃描會主動探測遠端,有操作與合規邊界。
官方倉庫:
https://github.com/alpadalar/netops-mcp
3 分鐘完成第一次嘗試
官方推薦路徑只有一條:複製後用 uv 建環境並做可編輯安裝。不要另找安裝程式,也不要第一次改 HTTP 模式。
git clone https://github.com/alpadalar/netops-mcp.git
cd netops-mcp
uv venv
source .venv/bin/activate
uv pip install -e .
複製地址:
https://github.com/alpadalar/netops-mcp.git
前置條件:Python >= 3.10、uv、Linux 或 macOS。本頁沒有連續寫出 stdio 啟動行,安裝完成後把該環境提供的入口寫進用戶端,不要編造命令。
uv 說明:
https://github.com/astral-sh/uv
連上後做一次低風險呼叫:使用已證實的 ping,只對你有權探測的主機發探測。不要呼叫 nmap,也不要開 HTTP 模式。ping 會對外連線發包。
成功訊號:回傳探測結果,且沒有連接埠掃描、沒有 HTTP 監聽。若安裝失敗,先核對是否在 Linux/macOS 以及 uv 是否可用。
使用案例
案例一:連通性。對象是 ping,同一組還有 traceroute、mtr、telnet、netcat。第一次只用 ping。證據沒有參數表,成功以回傳探測輸出為準。不要對未授權目標探測。
案例二:DNS 查詢。對象是 nslookup、dig、host。這是另一類唯讀查詢。只查你已知的域名。不要和 HTTP 組的 curl、httpie、api_test 混成第一次步驟。證據沒有函式封裝細節,只使用用戶端實際顯示的 DNS 工具。
使用邊界
HTTP 模式預設需要介面金鑰,沒有金鑰會拒絕啟動。鑑權說明:
https://github.com/alpadalar/netops-mcp#authentication
那不是第一次路徑。nmap 與系統監控會讀取或探測更多資訊,確認點是你已接受探測範圍和本地指標將進入對話之後,再行動。未點名的監聽地址、金鑰變數和 Windows 變通不要補。官方沒有寫出解除安裝步驟。