Huntress-MCP-Server

ハントレス API MCP サーバー

Huntress APIと連携するためのツールを提供するモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、アカウント管理、組織管理、エージェント管理、インシデントレポートなど、Huntressの機能へのプログラムによるアクセスを可能にします。

特徴

• アカウント情報の取得
• 組織管理
• エージェントの管理と監視
• インシデントレポートへのアクセス
• 概要レポートの生成
• 請求レポートへのアクセス
• レート制限が組み込まれています（1分あたり60リクエスト）
• エラー処理とレスポンスのフォーマット

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Huntress API MCP Server を自動的にインストールするには:

手動インストール

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 シークレットキー

これらは、API 認証情報の下にある<your_account_subdomain>.huntress.ioにある Huntress アカウントから取得できます。

MCPでの使用

MCP 設定に次の構成を追加します。

レート制限

サーバーは、Huntress APIのレート制限（スライディングウィンドウ上で1分あたり60リクエスト）を実装しています。これは以下のことを意味します。

• 60秒間に60件を超えるリクエストは送信できません
• ウィンドウはスライドするので、リクエスト1がT0で行われ、リクエスト60がT30で行われた場合、リクエスト61はT60まで待たなければなりません。

エラー処理

サーバーはさまざまなエラー シナリオを処理します。

• 無効なAPI認証情報
• レート制限を超えました
• 無効なリクエストパラメータ
• API応答エラー

ライセンス

MITライセンス - 詳細はLICENSEファイルを参照