Install
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 이상을 요구한다. 네트워크 도구는 OS에 묶여 있으며 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를 쓸 수 있는지 먼저 대조한다.
사용 사례
사례 1: 연결성. 대상은 ping이다. 같은 묶음에 traceroute, mtr, telnet, netcat도 있다. 처음에는 ping만 쓴다. 증거에 인자 표가 없다. 성공은 탐지 출력이 돌아오는 것이다. 인가되지 않은 대상을 탐지하지 말 것.
사례 2: DNS 조회. 대상은 nslookup, dig, host다. 다른 종류의 읽기 전용 조회다. 이미 아는 도메인만 조회한다. HTTP 묶음의 curl, httpie, api_test와 첫 단계를 섞지 말 것. 증거에 함수 래핑 세부 사항이 없다. 클라이언트가 실제로 보여 주는 DNS 도구만 쓴다.
사용 경계
HTTP 모드는 기본으로 인터페이스 키가 필요하다. 키가 없으면 시작을 거부한다. 인증 설명:
https://github.com/alpadalar/netops-mcp#authentication
그것은 첫 경로가 아니다. nmap과 시스템 모니터링은 더 많은 정보를 읽거나 탐지한다. 확인점은 탐지 범위와 이 기기의 지표가 대화에 들어갈 것을 받아들인 뒤 행동하는 것이다. 지목되지 않은 대기 주소, 키 변수, Windows 우회를 보태지 말 것. 공식은 제거 설치 단계를 쓰지 않았다.