Huntress-MCP-Server

헌트리스 API MCP 서버

Huntress API와 상호 작용하기 위한 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 계정 관리, 조직 관리, 에이전트 관리, 인시던트 보고서 등 Huntress 기능에 프로그래밍 방식으로 액세스할 수 있습니다.

특징

• 계정 정보 검색
• 조직 관리
• 에이전트 관리 및 모니터링
• 사고 보고서 접근
• 요약 보고서 생성
• 청구 보고서 액세스
• 내장된 속도 제한(분당 60개 요청)
• 오류 처리 및 응답 형식 지정

설치

Smithery를 통해 설치

Smithery를 통해 Claude Desktop에 Huntress API MCP 서버를 자동으로 설치하려면:

지엑스피1

수동 설치

1. 저장소를 복제합니다
2. 종속성 설치:

3. .env.example 기반으로 .env 파일을 만듭니다.

4. 서버를 빌드하세요:

사용 가능한 도구

계정 관리

• get_account_info : 현재 계좌에 대한 정보를 가져옵니다.

조직 관리

• list_organizations : 계정의 조직을 나열합니다.
• get_organization : 특정 조직의 세부 정보를 가져옵니다.

에이전트 관리

• list_agents : 계정의 에이전트를 나열합니다.
• get_agent : 특정 에이전트의 세부 정보를 가져옵니다.

사고 보고서

• list_incident_reports : 사고 보고서 목록
• get_incident_report : 특정 사고 보고서의 세부 정보를 가져옵니다.

요약 보고서

• list_summary_reports : 목록 요약 보고서
• get_summary_report : 특정 요약 보고서의 세부 정보를 가져옵니다.

청구 보고서

• list_billing_reports : 청구 보고서 목록
• get_billing_report : 특정 청구 보고서의 세부 정보를 가져옵니다.

구성

서버에는 다음과 같은 환경 변수가 필요합니다.

• HUNTRESS_API_KEY : Huntress API 키
• HUNTRESS_API_SECRET : Huntress API 비밀 키

해당 정보는 <your_account_subdomain>.huntress.io 의 Huntress 계정에서 API 자격 증명을 통해 얻을 수 있습니다.

MCP와 함께 사용

MCP 설정에 다음 구성을 추가하세요.

속도 제한

이 서버는 슬라이딩 윈도우에서 분당 60개의 요청으로 Huntress API의 속도 제한을 구현합니다. 이는 다음을 의미합니다.

• 60초 기간 내에 최대 60개의 요청을 할 수 없습니다.
• 창이 슬라이드되므로 요청 1이 T0에서 이루어지고 요청 60이 T30에서 이루어지면 요청 61은 T60까지 기다려야 합니다.

오류 처리

서버는 다양한 오류 시나리오를 처리합니다.

• 잘못된 API 자격 증명
• 요금 제한을 초과했습니다
• 잘못된 요청 매개변수
• API 응답 오류

특허

MIT 라이선스 - 자세한 내용은 라이선스 파일을 참조하세요.