mcp-netdisco

MCP 클라이언트에게 Netdisco에 대한 읽기 전용 액세스를 제공하는 Docker 기반 Model Context Protocol (MCP) 서버입니다.

기능

• Netdisco의 /login 엔드포인트를 HTTP Basic 자격 증명과 함께 사용

• 반환된 API 키를 캐시하고 30일마다 갱신

• Netdisco가 HTTP 401을 반환하면 자동으로 재인증

• 요청을 구성된 Netdisco 서버의 상대 경로로 제한

• Docker 컨테이너를 실행하는 클라이언트를 위해 MCP stdio로 실행

Related MCP server: kismet-wireless-mcp

구성

.env 파일을 생성하세요. 기본 URL은 프로덕션 Netdisco 서버입니다:

NETDISCO_URL=http://your-url-site.com:5000
NETDISCO_USERNAME=your-netdisco-username
NETDISCO_PASSWORD=your-netdisco-password
NETDISCO_TIMEOUT=20

사용자 이름과 비밀번호는 POST /login에서 API 키를 얻는 데만 사용됩니다. .env 파일을 커밋하지 마세요.

Docker

직접 빌드하고 실행:

docker build -t mcp-netdisco .
docker run --rm -i --env-file .env mcp-netdisco

또는 Compose 사용:

docker compose build
docker compose run --rm -T mcp-netdisco

MCP 도구

서버는 다음을 노출합니다:

netdisco_api(path, query)

• path: /api/v1/search/device와 같은 Netdisco API의 상대 경로

• query: 선택적 쿼리 문자열 매개변수

데이터 호출에는 HTTP GET 요청만 지원됩니다. 절대 URL은 거부되며, 요청은 다른 호스트로 리디렉션될 수 없습니다.

Netdisco 토큰 수명

서버는 캐시된 API 키를 30일마다 갱신하며 401 응답 후 한 번 재시도합니다. Netdisco의 api_token_lifetime 설정은 갱신 간격보다 길어야 합니다(또는 필요 시 401 재시도가 새 키를 획득합니다). 갱신 간격은 필요할 경우 나중에 구성 가능하도록 만들 수 있습니다.

개발

python3 -m venv .venv
. .venv/bin/activate
pip install -e .
export NETDISCO_USERNAME=your-user
export NETDISCO_PASSWORD=your-password
python -m mcp_netdisco

라이선스

아직 선택된 라이선스가 없습니다.