휘슬 MCP 서버

프로젝트 소개

Whistle MCP 서버는 모델 컨텍스트 프로토콜(MCP) 기반의 Whistle 프록시 관리 도구로, AI 비서가 로컬 Whistle 프록시 서버를 직접 운영하고 제어할 수 있도록 합니다. 이 도구를 통해 AI는 사용자가 Whistle 인터페이스를 직접 조작하지 않고도 규칙, 그룹, 값을 관리하고, 네트워크 요청을 모니터링하고, 요청을 재생 및 수정하는 등의 작업을 수행할 수 있도록 지원합니다. 네트워크 디버깅, API 테스트 및 프록시 규칙 관리 프로세스를 크게 간소화하여 사용자가 AI와의 자연어 상호 작용을 통해 복잡한 네트워크 프록시 구성 작업을 완료할 수 있도록 지원합니다.

특징

규칙 관리 : Whistle 규칙 생성, 업데이트, 이름 변경, 삭제 및 활성화/비활성화
그룹 관리 : 그룹 생성, 이름 변경, 삭제, 규칙 및 그룹 간 작업 연결
값 관리 : 값 그룹 관리 지원을 통해 값을 생성, 업데이트, 이름 변경 및 삭제합니다.
프록시 제어 : 프록시, HTTP/HTTPS 가로채기, HTTP/2 프로토콜 등을 활성화/비활성화합니다.
요청 가로채기 : URL 필터링 지원을 통해 가로채기된 네트워크 요청 정보를 확인합니다.
요청 재생 : 사용자 정의 요청 매개변수를 사용하여 캡처된 요청 재생 지원
다중 규칙 모드 : 다중 규칙 모드 활성화/비활성화 지원

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop용 Whistle MCP Server를 자동으로 설치하려면:

지엑스피1

수동 설치

npm을 통해 Whistle MCP 서버를 전역적으로 설치할 수 있습니다.

npm install -g whistle-mcp-tool

MCP 구성

설치 후 MCP JSON 구성 파일에서 Whistle MCP를 구성할 수 있습니다.

{
  "mcpServers": {
    "whistle-mcp": {
      "command": "whistle-mcp",
      "args": [
        "--host=<whistle server IP address>",
        "--port=<whistle server port number>"
      ]
    }
  }
}

구성 세부 정보

호스트: Whistle 서버 IP 주소, 구성되지 않은 경우 기본적으로 localhost로 설정됨
포트: Whistle 서버 포트 번호, 구성되지 않은 경우 기본값은 8899입니다.

AI 클라이언트에서 MCP JSON 구성

클로드 클라이언트: https://modelcontextprotocol.io/quickstart/user
레이캐스트: MCP 플러그인 설치가 필요합니다.
커서: https://docs.cursor.com/context/model-context-protocol#configuring-mcp-servers

MCP 도구 설명

Whistle MCP 서버는 MCP 프로토콜을 통해 호출할 수 있는 다음 도구를 제공합니다.

규칙 관리

도구 이름	설명	기능
getRules	모든 규칙을 얻으세요	생성된 모든 규칙과 그 내용을 나열합니다.
생성규칙	새로운 규칙 만들기	지정된 이름으로 새 규칙을 만듭니다.
업데이트 규칙	규칙 내용 업데이트	지정된 규칙의 내용을 수정합니다
이름 바꾸기 규칙	규칙 이름 바꾸기	규칙을 새 이름으로 변경
규칙 삭제	규칙 삭제	지정된 이름의 규칙을 삭제합니다.
선택 규칙	규칙 활성화	지정된 이름으로 규칙 활성화
선택 취소 규칙	규칙 비활성화	지정된 이름으로 규칙을 비활성화합니다.
모든 규칙 비활성화	모든 규칙 비활성화	생성된 모든 규칙을 한 번에 비활성화합니다.

그룹 관리

도구 이름	설명	기능
그룹 생성	그룹 만들기	지정된 이름으로 새 규칙 그룹을 만듭니다.
그룹 이름 바꾸기	그룹 이름 바꾸기	규칙 그룹을 새 이름으로 변경
그룹 삭제	그룹 삭제	지정된 이름을 가진 규칙 그룹을 삭제합니다.
그룹으로 이동 규칙	규칙을 그룹으로 이동	지정된 규칙을 특정 그룹으로 이동합니다.
그룹 밖으로 이동 규칙	그룹 밖으로 규칙 이동	규칙을 그룹에서 최상위 수준으로 이동합니다.

가치 관리

도구 이름	설명	기능
모든 값을 가져옵니다	모든 값을 가져옵니다	생성된 모든 값과 값 그룹을 나열합니다.
생성값	새로운 가치를 창출하다	지정된 이름으로 새 값을 만듭니다.
업데이트값	가치 콘텐츠 업데이트	지정된 값의 내용을 수정합니다
renameValue	값 이름 바꾸기	값을 새 이름으로 변경
삭제값	값 삭제	지정된 이름의 값을 삭제합니다
createValueGroup	가치 그룹 생성	지정된 이름으로 새 값 그룹을 만듭니다.
값 그룹 이름 바꾸기	값 그룹 이름 바꾸기	값 그룹을 새 이름으로 바꾸기
deleteValueGroup	값 그룹 삭제	지정된 이름을 가진 값 그룹을 삭제합니다.
moveValueToGroup	값을 그룹으로 이동	지정된 값을 특정 그룹으로 이동합니다.
그룹 밖으로 이동	그룹 밖으로 값 이동	값을 그룹에서 최상위 수준으로 이동합니다.

프록시 제어

도구 이름	설명	기능
상태 가져오기	서버 상태 가져오기	Whistle 서버의 현재 상태 정보를 가져옵니다.
토글프록시	프록시 활성화/비활성화	Whistle 프록시의 활성화 상태를 전환합니다.
토글HttpsInterception	HTTPS 가로채기 활성화/비활성화	HTTPS 요청 가로채기의 활성화 상태를 전환합니다.
토글Http2	HTTP2 활성화/비활성화	HTTP/2 프로토콜 지원의 활성화 상태를 전환합니다.
토글멀티룰모드	다중 규칙 모드 활성화/비활성화	여러 규칙을 동시에 활성화할지 여부를 전환합니다.

요청 관리

도구 이름	설명	기능
getInterceptInfo	차단 정보 얻기	필터링 지원을 통해 Whistle에서 가로채는 네트워크 요청 정보를 가져옵니다.
재생요청	리플레이 요청	사용자 정의 가능한 매개변수를 사용하여 지정된 네트워크 요청을 다시 보냅니다.

연락처 정보

이메일: gz7gugu@qq.com
블로그: https://7gugu.com

whistle-mcp

Integrations