安装
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 变通不要补。官方没有写出卸载步骤。