ハントレス 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手動インストール
リポジトリをクローンする
依存関係をインストールします:
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ファイルを参照