ハントレス API MCP サーバー

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

特徴

• アカウント情報の取得

• 組織管理

• エージェントの管理と監視

• インシデントレポートへのアクセス

• 概要レポートの生成

• 請求レポートへのアクセス

• レート制限が組み込まれています（1分あたり60リクエスト）

• エラー処理とレスポンスのフォーマット

Related MCP server: mcp-server-aistor

インストール

Smithery経由でインストール

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

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

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

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件を超えるリクエストは送信できません

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

エラー処理

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

• 無効なAPI認証情報

• レート制限を超えました

• 無効なリクエストパラメータ

• API応答エラー

ライセンス

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