Dynamicendpoints Huntress MCP Server

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

このサーバーは、Huntress API とのやり取りを可能にするモデルコンテキストプロトコル（MCP）サーバーです。プログラムを通じて、アカウント管理、組織管理、エージェント管理、事故報告、要約報告など、Huntress の様々な機能にアクセスできます。

✨ 主な機能

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

📦 インストール

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 ファイルを参照してください。