피홀-MCP-세러

Pi-hole용 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버는 AI 비서가 사용할 수 있는 도구로서 Pi-hole 기능을 제공합니다.

특징

• ListLocalDNS : Pi-hole에서 모든 로컬 DNS 설정을 반환합니다.
• ListQueries : Pi-hole에서 최근 DNS 쿼리 기록을 반환합니다.
• 다중 Pi-hole 지원 : 단일 MCP 서버에서 최대 4개의 Pi-hole 관리
• ...더 많은 내용이 나올 예정입니다...

종속성

도커

• Docker 설치 가이드

uv (선택 사항, 개발용)

애플리케이션을 로컬에서 실행하려면 uv 사용하세요. 원하는 패키지 관리자를 사용하여 설치하세요.

환경

Pi-hole 자격 증명을 사용하여 프로젝트 루트에 .env 파일을 만듭니다.

지엑스피1

도커 배포

Docker에서 Pi-hole MCP 서버를 실행합니다.

Docker Compose 사용

1. 컨테이너를 당겨서 시작하세요:
   docker-compose up -d
2. 서버는 http://localhost:8383 에서 사용할 수 있습니다.

수동 Docker 빌드

또는 Docker 컨테이너를 수동으로 빌드하고 실행할 수 있습니다.

로컬로 실행

Docker 배포는 호스트와 컨테이너 간의 양방향 통신을 위해 SSE 모드를 사용합니다. (이론적으로) Docker exec 명령으로 STDIO 모드를 사용할 수 있습니다. 로컬에서 실행하려면 uv 명령을 사용하면 됩니다. 이 명령은 내장된 mcp 개발 유틸리티를 사용하여 도구와 리소스를 빠르게 검사하는 데 특히 유용합니다. 예를 들면 다음과 같습니다.

그런 다음 웹 브라우저에서 http://localhost:6274 로 이동합니다.

API

이 MCP 서버는 다음과 같은 리소스와 도구를 제공합니다.

자원

• piholes:// : 구성된 모든 Pi-hole에 대한 정보를 반환합니다.

도구

• list_local_dns : Pi-hole의 모든 로컬 DNS 설정을 나열합니다.
• list_queries : Pi-hole에서 최근 DNS 쿼리 기록을 가져옵니다.

각 도구 호출은 다음 구조의 사전 목록으로 결과를 반환합니다.

goose 테스트

Goose는 테스트 및 개발에 유용한 CLI LLM 클라이언트입니다. 여기에서 설치 지침을 확인하세요.

다음 내용은 goose configure 사용하여 초기 설정을 완료했다고 가정합니다.

확장 프로그램 구성

1. goose configure 입력하여 구성 메뉴를 엽니다.
2. 확장 프로그램 추가를 선택하세요
3. 원격 확장 프로그램 선택
4. 이름을 입력하라고 하는데, 뭐라 부르든 상관없어요. 저는 pihole-mcp 라고 이름 지었어요.
5. "SSE 엔드포인트 URI는 무엇입니까?"라는 질문이 나오면 http://localhost:8383/sse 입력합니다.
6. 시간 초과를 입력하세요.
7. 원하시면 설명을 추가하세요.
8. 환경 변수에 대한 질문이 나오면 아니요를 선택하세요.

세션 시작

서버가 설치되면 채팅 세션을 시작하세요.

"내 로컬 DNS 레코드는 무엇인가요?" 라고 질문해보세요.

...또는 "최근 DNS 쿼리를 보여주세요." 라고 말합니다.

클로드 데스크탑

Claude의 데스크톱 클라이언트는 현재 STDIO 프로토콜만 지원하지만, 프록시를 사용하여 SSE 엔드포인트와 통신할 수 있습니다.

claude_desktop_config.json 파일에 다음을 추가하세요.

로컬 네트워크의 다른 호스트에 연결하고 보안되지 않은 연결을 사용하는 경우, --allow-http 인수를 사용하여 해당 연결을 명시적으로 허용해야 합니다. 예:

그런 다음 애플리케이션을 완전히 재시작하고 사용해보세요.

특허

MIT