Huntress

🚀 ハントレス API MCP サーバー

このサーバーは、Model Context Protocol (MCP) を使用して、Huntress API との相互作用を可能にするツールを提供します。これにより、アカウント管理、組織管理、エージェント管理、イベントレポート、要約レポートなど、様々な機能にプログラムでアクセスできます。

✨ 主な機能

• アカウント情報の取得
• 組織管理
• エージェントの管理と監視
• イベントレポートの取得
• 要約レポートの生成
• 請求レポートの取得
• 組み込みのレート制限（1分間に60回のリクエスト）
• エラー処理とレスポンスの整形

📦 インストール

Smithery を使用したインストール

Smithery を通じて、Claude デスクトップ版用に Huntress API MCP サーバーを自動インストールできます。

npx -y @smithery/cli install huntress-mcp-server --client claude

手動インストール

1. リポジトリをクローンします。
2. 依存関係をインストールします。

   npm install
   

3. .env.example を元に .env ファイルを作成します。

   HUNTRESS_API_KEY=your_api_key_here
   HUNTRESS_API_SECRET=your_api_secret_here
   

4. サーバーをビルドします。

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

これらは、あなたの Huntress アカウント <your_account_subdomain>.huntress.io の「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"
      }
    }
  }
}

レート制限

サーバーは Huntress API のレート制限を実装しており、1分間に60回のリクエストが許可されています（スライディングウィンドウ方式）。これは以下の意味を持ちます。

• 任意の60秒間の期間で、最大60回のリクエストが可能です。
• ウィンドウはスライディングするため、最初のリクエストが T0 で、60回目のリクエストが T30 の場合、61回目のリクエストは T60 まで待つ必要があります。

エラー処理

サーバーは以下のような様々なエラーシナリオを処理します。

• 無効な API 資格情報
• レート制限の超過
• 無効なリクエストパラメータ
• API レスポンスエラー

📄 ライセンス

MIT ライセンス - 詳細は LICENSE ファイルを参照してください。