MCP(Model Context Protocol)サーバーは、AIモデルと自動化ツールを提供し、TheHiveインシデント対応プラットフォームへのアクセスを提供します。

概要

このサーバーは、MCP クライアント (AI アシスタント) と TheHive のブリッジとして機能し、次のようにします。

• セキュリティアラートの取得と分析 ・アクセスケース情報
• ケースにアラートをプロモート
• 事件対応業務の遂行

##特徴

利用可能なツール

1.get thehive alerts - TheHive からアラートのリストを取得する

• オプション[limitパラメータ(デフォルト:100)
• ID、タイトル、重症度、ステータスを含むフォーマットされたアラート情報を返す

2.get thehive alert by id - 特定のアラートに関する詳細情報を入手

• 必須[[T1]パラメータ
• 包括的なアラートの詳細を返す

3。get thehive cases - TheHive からケースのリストを取得する

• オプション[limitパラメータ(デフォルト:100)
• フォーマットされたケース情報を返す

4.get thehive case by id - 特定のケースに関する詳細情報を入手

• 必須[[T3]パラメータ
• 包括的なケースの詳細を返す

5.promote alert to case - ケースにアラートをプロモート

• 必須[[T4]パラメータ

MCP Server for TheHive

An MCP (Model Context Protocol) server that provides AI models and automation tools with access to TheHive incident response platform.

Overview

This server acts as a bridge between MCP clients (like AI assistants) and TheHive, allowing them to:

• Retrieve and analyze security alerts
• Access case information
• Promote alerts to cases
• Perform incident response operations

Features

Available Tools

1. get_thehive_alerts - Retrieve a list of alerts from TheHive

   • Optional limit parameter (default: 100)
   • Returns formatted alert information including ID, title, severity, and status

2. get_thehive_alert_by_id - Get detailed information about a specific alert

   • Required alert_id parameter
   • Returns comprehensive alert details

3. get_thehive_cases - Retrieve a list of cases from TheHive

   • Optional limit parameter (default: 100)
   • Returns formatted case information

4. get_thehive_case_by_id - Get detailed information about a specific case

   • Required case_id parameter
   • Returns comprehensive case details

5. promote_alert_to_case - Promote an alert to a case

   • Required alert_id parameter
   • Returns information about the newly created case

6. create_thehive_case - Create a new case in TheHive

   • Required title and description parameters
   • Optional parameters: severity, tags, tlp, pap, status, assignee, case_template, start_date
   • Returns information about the newly created case

Installation

Prerequisites

• Access to a TheHive 5 instance
• Valid TheHive API token

Downloading Pre-compiled Binaries

You can download pre-compiled binaries for various operating systems from the GitHub Releases page. Download the appropriate binary for your system, make it executable, and place it in your desired location.

Building from Source

git clone 
cd mcp-server-thehive
cargo build --release

Configuration

The server requires the following environment variables:

• THEHIVE_URL - TheHive API base URL (default: http://localhost:9000/api)
• THEHIVE_API_TOKEN - TheHive API token (required)
• VERIFY_SSL - Whether to verify SSL certificates (default: false)
• RUST_LOG - Logging level (optional, e.g., debug, info)

Environment File

Create a .env file in the project root:

THEHIVE_URL=https://your-thehive-instance.com/api
THEHIVE_API_TOKEN=your-api-token-here
VERIFY_SSL=true
RUST_LOG=info

Getting a TheHive API Token

1. Log into your TheHive instance
2. Go to User Settings → API Keys
3. Click Create API Key
4. Copy the generated token and use it as THEHIVE_API_TOKEN

Usage

Running the Server

# Using cargo
cargo run

# Using the built binary
./target/release/mcp-server-thehive

Integration with MCP Clients