defined-mcp

Defined Networking API를 위한 MCP 서버입니다.

설치

uv tool install git+https://github.com/quickvm/defined-mcp.git

특정 버전이나 브랜치를 설치하려면:

uv tool install git+https://github.com/quickvm/defined-mcp.git@main

로컬 개발 환경:

git clone git@github.com:quickvm/defined-mcp.git
cd defined-mcp
uv tool install --editable .

Related MCP server: UniFi MCP Server

구성

DEFINED_API_KEY 환경 변수를 Defined Networking API 키로 설정하세요. 관리자 패널에서 키를 얻을 수 있습니다.

export DEFINED_API_KEY=dnkey-...

사용법

Claude Code에 추가

claude mcp add defined_mcp -- defined-mcp serve

그런 다음 Claude Code를 재시작하세요.

연결 확인

defined-mcp check

독립 실행형으로 실행

defined-mcp serve

사용 가능한 도구

호스트

• list_hosts — 필터(역할, 차단됨, 라이트하우스, 릴레이)를 사용하여 호스트 목록 조회

• get_host — 호스트 세부 정보 조회

• create_host — 호스트/라이트하우스/릴레이 생성

• update_host — 호스트 업데이트(전체 교체)

• delete_host — 호스트 삭제

• block_host / unblock_host — 호스트 차단/차단 해제

• add_host_tag / remove_host_tag — 호스트에 태그 추가/제거

• create_enrollment_code — 등록 코드 생성

• create_host_and_enrollment_code — 호스트 및 등록 코드 생성

역할 및 방화벽 규칙

• list_roles / get_role — 방화벽 규칙이 포함된 역할 목록 조회/가져오기

• create_role / update_role — 역할 생성/업데이트(전체 교체)

• delete_role — 역할 삭제

• add_firewall_rule — 역할에 방화벽 규칙 추가(플랫 매개변수, JSON 없음)

• remove_firewall_rule — 인덱스로 방화벽 규칙 제거

태그

• list_tags / get_tag — 태그 목록 조회/가져오기

• create_tag / update_tag — 구성 재정의를 포함하여 태그 생성/업데이트

• delete_tag — 태그 삭제

• add_tag_config_override — 태그에 구성 재정의 추가/교체

• remove_tag_config_override — 키로 구성 재정의 제거

네트워크

• list_networks / get_network — 네트워크 목록 조회/가져오기

• create_network / update_network — 네트워크 생성/업데이트

경로

• list_routes / get_route — 방화벽 규칙이 포함된 경로 목록 조회/가져오기

• create_route / update_route — 경로 생성/업데이트(전체 교체)

• delete_route — 경로 삭제

• add_route_firewall_rule — 경로에 방화벽 규칙 추가

• remove_route_firewall_rule — 인덱스로 경로 방화벽 규칙 제거

기타

• list_audit_logs — 필터를 사용한 감사 로그

• list_downloads — 소프트웨어 다운로드 링크(인증되지 않음)

Claude Code 스킬

이 저장소에는 대화형 네트워크 관리를 위한 Claude Code 스킬이 포함되어 있습니다. 이 저장소에서 Claude Code를 실행하면 /network-architect 명령을 자동으로 사용할 수 있습니다.

모든 프로젝트에서 이 스킬을 사용하려면 Claude Code 프로필로 복사하세요:

cp -r .claude/skills/network-architect ~/.claude/skills/

/network-architect audit

Defined Networking 계정에 대한 보안 및 구성 감사를 수행합니다. 모든 네트워크, 역할, 태그, 호스트를 가져온 후 다음을 보고합니다:

• 누락되었거나 지나치게 허용적인 방화벽 규칙이 있는 역할

• 죽은 태그(할당된 호스트가 0개인 태그)

• 태그가 없거나, 오래된 dnclient 버전이거나, 마지막 접속 시간이 오래된 호스트

• 포트/프로토콜/태그 세부 정보가 포함된 역할별 방화벽 적용 범위 요약

/network-architect design

대화형 방화벽 정책 설계 세션입니다. 서비스, 액세스 요구 사항, 세분화 요구 사항에 대해 질문한 후 다음을 제안합니다:

• 역할 구조(각 호스트 유형이 무엇인지)

• 태그 분류(ssh:allow와 같은 액세스 태그, user-type:admin과 같은 ID 태그)

• AND 논리(역할 + 태그)를 사용한 표 형식의 역할별 방화벽 규칙

/network-architect apply

원자적 도구(add_firewall_rule, add_host_tag 등)를 사용하여 네트워크 설계를 구현합니다. 먼저 현재 상태를 읽고, 차이점을 보여주고, 확인을 요청한 다음, 적용 후 검증합니다.

라이선스

MIT