remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Used for managing API credentials and environment configuration for the Huntress API server.
Used for installing dependencies and building the Huntress API MCP server.
헌트리스 API MCP 서버
Huntress API와 상호 작용하기 위한 도구를 제공하는 모델 컨텍스트 프로토콜(MCP) 서버입니다. 이 서버를 통해 계정 관리, 조직 관리, 에이전트 관리, 인시던트 보고서 등 Huntress 기능에 프로그래밍 방식으로 액세스할 수 있습니다.
특징
- 계정 정보 검색
- 조직 관리
- 에이전트 관리 및 모니터링
- 사고 보고서 접근
- 요약 보고서 생성
- 청구 보고서 액세스
- 내장된 속도 제한(분당 60개 요청)
- 오류 처리 및 응답 형식 지정
설치
Smithery를 통해 설치
Smithery를 통해 Claude Desktop에 Huntress API MCP 서버를 자동으로 설치하려면:
지엑스피1
수동 설치
- 저장소를 복제합니다
- 종속성 설치:
.env.example
기반으로.env
파일을 만듭니다.
- 서버를 빌드하세요:
사용 가능한 도구
계정 관리
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 라이선스 - 자세한 내용은 라이선스 파일을 참조하세요.