remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Used for managing API credentials and environment configuration for the Huntress API server.
Used for installing dependencies and building the Huntress API MCP server.

ハントレス API MCP サーバー

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

特徴

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

インストール

Smithery経由でインストール

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

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

手動インストール

リポジトリをクローンする
依存関係をインストールします:

npm install

.env.exampleに基づいて.envファイルを作成します。

HUNTRESS_API_KEY=your_api_key_here
HUNTRESS_API_SECRET=your_api_secret_here

サーバーを構築します。

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ファイルを参照

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Tools

View all tools

Huntress API統合用のMCPサーバー

Huntress-MCP-Server