Huntress MCP Server

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

Huntress API とのインタラクションツールを提供する Model Context Protocol (MCP) サーバーです。このサーバーは、アカウント管理、組織管理、エージェント管理、イベントレポート、要約レポートなど、様々な機能に対するプログラミングアクセスインターフェースを提供します。

✨ 主な機能

• アカウント情報の検索
• 組織管理
• エージェントの管理と監視
• イベントレポートへのアクセス
• 要約レポートの生成
• 費用レポートへのアクセス
• 組み込みのレート制限（毎分 60 回のリクエスト）
• エラー処理とレスポンスの整形

📦 インストール

Smithery を通じたインストール

Smithery を通じて、Claude Desktop で使用する 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 Key
• HUNTRESS_API_SECRET: あなたの Huntress API Secret Key

これらは、あなたの 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 のレート制限を実装しており、毎分 60 回のリクエストのスライディングウィンドウが適用されます。これは以下のことを意味します：

• 60 秒の期間内に、最大 60 回のリクエストを実行できます。
• ウィンドウは動的に移動します。例えば、リクエスト 1 が T0 で発行され、リクエスト 60 が T30 で発行された場合、リクエスト 61 は T60 まで待機する必要があります。

エラー処理

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

• 無効な API 証憑情報
• リクエストのタイムアウト
• ネットワーク接続問題

📄 ライセンス

[ここに該当する場合はライセンス情報を指定してください]

このドキュメントは、Huntress API MCP サーバーの完全な機能概要と使用ガイドを提供しています。さらなる支援や詳細情報が必要な場合は、関連ドキュメントを参照するか、サポートチームにお問い合わせください。