Huntress-MCP-Server

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

수동 설치

  1. 저장소를 복제합니다
  2. 종속성 설치:
npm install
  1. .env.example 기반으로 .env 파일을 만듭니다.
HUNTRESS_API_KEY=your_api_key_here HUNTRESS_API_SECRET=your_api_secret_here
  1. 서버를 빌드하세요:
npm run build

사용 가능한 도구

계정 관리

  • 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 설정에 다음 구성을 추가하세요.

{ "mcpServers": { "huntress": { "command": "node", "args": ["path/to/huntress-server/build/index.js"], "env": { "HUNTRESS_API_KEY": "your_api_key_here", "HUNTRESS_API_SECRET": "your_api_secret_here" } } } }

속도 제한

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

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

오류 처리

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

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

특허

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

ID: hry99k6xc2