Skip to main content
Glama
nks1097

TheHive MCP Server

by nks1097
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

🐝 TheHive MCP Server

Python 3.11+ MCP License: Apache-2.0

TheHive MCP Server é um servidor MCP (Model Context Protocol) dedicado à gestão de incidentes, triagem forense, resposta a incidentes, análise automatizada via Cortex e sincronização de inteligência de ameaças via MISP, construído sobre a API do TheHive 5.

🛠️ Catálogo Completo de Ferramentas MCP (70 Tools)

📁 1. Gestão de Casos e Investigações (15 Tools)

Nº

Ferramenta MCP

Descrição Operacional

01

criar_caso_thehive

Cria um novo caso de incidente de segurança no TheHive.

02

listar_casos_thehive

Lista os casos de incidentes mais recentes no TheHive.

03

obter_caso_thehive

Obtém detalhes completos de um caso de incidente pelo ID.

04

atualizar_caso_thehive

Atualiza descrição, severidade, status, resolução ou responsável.

05

deletar_caso_thehive

Exclui um caso de incidente do TheHive.

06

fechar_caso_thehive

Fecha um caso com veredito (TruePositive, FalsePositive, Indeterminate).

07

reabrir_caso_thehive

Reabre um caso encerrado no TheHive.

08

atribuir_caso_thehive

Atribui um responsável (usuário) a um caso no TheHive.

09

adicionar_tag_caso_thehive

Adiciona tags de identificação a um caso.

10

remover_tag_caso_thehive

Remove tags de um caso no TheHive.

11

obter_timeline_caso_thehive

Recupera a linha do tempo completa de eventos do caso.

12

listar_logs_caso_thehive

Lista logs de auditoria e atividades registradas em um caso.

13

buscar_casos_thehive

Pesquisa casos por qualquer termo (título, descrição, status, tag).

14

adicionar_comentario_caso_thehive

Adiciona um comentário técnico na aba de investigação.

15

buscar_casos_duplicados_thehive

Verifica se existe caso idêntico criado recentemente.

📋 2. Tarefas e Logs de Atividades (8 Tools)

Nº

Ferramenta MCP

Descrição Operacional

16

obter_tarefas_thehive

Busca tarefas (específica por ID, por caso ou gerais).

17

criar_tarefa_thehive

Cria uma nova tarefa dentro de um caso do TheHive.

18

atualizar_tarefa_thehive

Atualiza título, descrição, status ou responsável da tarefa.

19

concluir_tarefa_thehive

Marca uma tarefa de investigação como concluída.

20

atribuir_tarefa_thehive

Define o responsável por uma tarefa no TheHive.

21

remover_tarefa_thehive

Exclui uma tarefa do TheHive.

22

criar_tasklog_thehive

Cria um registro detalhado de log em uma tarefa.

23

adicionar_log_tarefa_thehive

Adiciona uma entrada de log a uma tarefa.

🔍 3. Observáveis e Evidências IOC (7 Tools)

Nº

Ferramenta MCP

Descrição Operacional

24

adicionar_observavel_thehive

Registra um IOC (IP, Hash, Domínio, URL) em um caso.

25

obter_observaveis_thehive

Lista todas as evidências e IOCs anexados a um caso.

26

criar_observavel_arquivo_thehive

Faz upload ou registra um observável do tipo arquivo.

27

atualizar_observavel_thehive

Atualiza IOC, tags, TLP, PAP ou flags de um observável.

28

deletar_observavel_thehive

Remove um observável do TheHive.

29

marcar_observavel_ioc_thehive

Marca ou desmarca um observável como IOC relevante.

30

marcar_observavel_sighted_thehive

Marca um observável como visto (Sighted) na infraestrutura.

🚨 4. Alertas de Segurança (9 Tools)

Nº

Ferramenta MCP

Descrição Operacional

31

obter_alertas_thehive

Lista ou obtém detalhes de alertas no TheHive.

32

criar_alerta_thehive

Cria um novo alerta de segurança no TheHive.

33

obter_alerta_thehive

Obtém detalhes completos de um alerta específico pelo ID.

34

atualizar_alerta_thehive

Atualiza título, descrição, tags ou status de um alerta.

35

deletar_alerta_thehive

Remove um alerta do TheHive pelo ID.

36

promover_alerta_para_caso_thehive

Converte/Promove um alerta do TheHive em um caso de incidente.

37

mesclar_alertas_thehive

Mescla alertas relacionados dentro de um caso existente.

38

buscar_alertas_thehive

Pesquisa alertas no TheHive por filtros ou termos.

39

excluir_alertas_duplicados_thehive

Identifica e exclui automaticamente todos os alertas duplicados em alta velocidade.

⚡ 5. Analisadores e Responders do Cortex (10 Tools)

Nº

Ferramenta MCP

Descrição Operacional

40

listar_analyzers_cortex

Lista analisadores disponíveis (VirusTotal, Shodan, etc.).

41

listar_analisadores_cortex

Alias para listagem de motores de análise disponíveis.

42

executar_analyzer_cortex

Executa um analisador do Cortex em um observável e aguarda relatório.

43

executar_analise_cortex

Submete observável para análise automatizada no Cortex.

44

listar_jobs_analyzer

Lista jobs de análise em andamento ou concluídos no Cortex.

45

listar_jobs_cortex

Lista histórico de execuções de jobs no Cortex.

46

obter_resultado_analyzer

Obtém o relatório/resultado final de um job de análise.

47

cancelar_job_cortex

Cancela um job de análise em execução no Cortex.

48

listar_responders_cortex

Lista os responders de resposta ativa disponíveis.

49

executar_responder_cortex

Executa uma ação de resposta ativa no Cortex.

🛡️ 6. Sincronização CTI com MISP (6 Tools)

Nº

Ferramenta MCP

Descrição Operacional

50

buscar_evento_misp

Pesquisa eventos e IOCs na inteligência de ameaças do MISP.

51

buscar_misp

Consulta genérica de IOC no MISP.

52

importar_evento_misp

Importa os detalhes de um evento do MISP para investigação.

53

exportar_caso_misp

Exporta e cria um evento de ameaça no MISP com base no caso.

54

publicar_evento_misp

Publica um novo evento no MISP.

55

sincronizar_iocs_misp

Sincroniza observáveis do caso com a base CTI do MISP.

🏛️ 7. Templates, Organizações, Usuários, Taxonomias e Campos (10 Tools)

Nº

Ferramenta MCP

Descrição Operacional

56

listar_case_templates_thehive

Lista os modelos/templates de casos cadastrados no TheHive.

57

criar_caso_template_thehive

Cria um caso baseado em um template pré-definido.

58

listar_organizacoes_thehive

Lista as organizações cadastradas na instância do TheHive.

59

listar_usuarios_thehive

Lista os usuários registrados no TheHive.

60

listar_tags_thehive

Lista todas as tags existentes usadas em casos e alertas.

61

listar_taxonomias_thehive

Lista as taxonomias disponíveis no TheHive.

62

adicionar_taxonomia_caso_thehive

Adiciona uma taxonomia (ex: veredito, categoria) a um caso.

63

listar_custom_fields_thehive

Lista os campos personalizados (Custom Fields) definidos.

64

atualizar_custom_field_thehive

Atualiza o valor de um campo personalizado em um caso.

65

buscar_similares_thehive

Busca casos semelhantes que compartilham dos mesmos IOCs.

📊 8. Estatísticas, Exportação, Importação e Diagnóstico (5 Tools)

Nº

Ferramenta MCP

Descrição Operacional

66

exportar_caso_thehive

Exporta um caso completo com observáveis e tarefas em JSON.

67

importar_caso_thehive

Importa um caso a partir de uma estrutura JSON.

68

estatisticas_thehive

Exibe estatísticas (casos abertos, fechados, severidades).

69

healthcheck_thehive

Verifica a saúde e conectividade com a API do TheHive.

70

versao_thehive

Retorna as informações de versão do servidor TheHive.

Related MCP server: cti-mcp-server

📦 Instalação e Configuração

git clone https://github.com/nks1097/TheHive-MCP-Server.git
cd TheHive-MCP-Server
python -m venv .venv
.venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env
python start_mcp.py

Configurar as variaveis de ambiente

Edite o arquivo .env com os dados da sua infraestrutura:

# TheHive Credenciais
THEHIVE_URL=ALTERE_SUA_URL
THEHIVE_API_KEY=ALTERE_SUA_API_KEY

# Cortex Credenciais (se no caso vc precisar usar)
CORTEX_URL=ALTERE_SUA_URL
CORTEX_API_KEY=ALTERE_SUA_API_KEY

# MISP Credentials (se no caso vc precisar usar)
MISP_URL=ALTERE_SUA_URL
MISP_API_KEY=ALTERE_SUA_API_KEY
MISP_VERIFY_SSL=false

# SSH para o Docker Host (for TheHive, Cortex, MISP) (se no caso vc precisar usar)
DOCKER_HOST_SSH_IP=ALTERE_SUA_URL
DOCKER_HOST_SSH_PORT=22
DOCKER_HOST_SSH_USER=ALTERE_SEU_USUARIO
DOCKER_HOST_SSH_PASS=ALTERE_SUA_SENHA

# App Settings
LOG_LEVEL=INFO
FAST_MCP_NAME=TheHive-MCP-Server
FAST_MCP_PORT=9000

  • Exemplo das configuraçoes do arquivo .env

    .env

🔌 Antigravity IDE (mcp_config.json)

Adicione ao arquivo C:\Users\<SeuUsuario>\.gemini\config\mcp_config.json:

{
  "mcpServers": {
    "soc-mcp-server": {
      "command": "C:\\Caminho\\Para\\TheHive-MCP-Server\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\Caminho\\Para\\TheHive-MCP-Server\\start_mcp.py"
      ],
      "env": {
        "FASTMCP_LOG_LEVEL": "CRITICAL",
        "FASTMCP_SHOW_SERVER_BANNER": "false",
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

  • imagem de Exemplo de configuração mcp_config.json para o Antigravity IDE

Configuração mcp_config.json na Antigravity IDE

LM Studio / Claude Desktop

{
  "mcpServers": {
    "soc-mcp-server": {
      "command": "C:\\Caminho\\Para\\TheHive-MCP-Server\\.venv\\Scripts\\python.exe",
      "args": [
        "C:\\Caminho\\Para\\TheHive-MCP-Server\\start_mcp.py"
      ]
    }
  }
}

  • imagem de Exemplo de configuração mcp_config.json para o LM Studio

    Configuração mcpServers no LM Studio

ChatGPT Codex

Adicione ao arquivo C:\Users\<SeuUsuario>\.codex\config.toml:

[mcp_servers.soc-ai]
command = "C:\\Caminho\\Para\\TheHive-MCP-Server\\.venv\\Scripts\\python.exe"
args = [
  "C:\\Caminho\\Para\\TheHive-MCP-Server\\start_mcp.py",
]

VIDEO DE CONFIGURAÇÃO DE FORMA SIMPLIFICADA USANDO GRATUITAMENTE LLM LOCAL COM LM STUDIO

▶️ Clique aqui para assistir ao vídeo completo no Google Drive Assiste em Full Hd (1080P)

📜 Licença

Distribuído sob a licença Apache 2.0. Veja o arquivo LICENSE para mais detalhes.

📂 Estrutura do Projeto

TheHive-MCP-Server/
├── src/
│   ├── config/
│   │   └── settings.py          # Configurações globais e variáveis de ambiente
│   ├── core/
│   │   └── http_client.py       # Cliente HTTP assíncrono (httpx) com tratamento de erros
│   ├── integrations/
│   │   ├── cortex/
│   │   │   └── client.py        # Cliente de integração com Cortex (Analyzers/Responders/Jobs)
│   │   ├── misp/
│   │   │   └── client.py        # Cliente de integração com MISP CTI
│   │   └── thehive/
│   │       └── client.py        # Cliente completo da API REST do TheHive 5
│   ├── tools/
│   │   ├── server.py            # Instanciação da aplicação FastMCP (TheHive-MCP-Server)
│   │   └── thehive_tools.py     # Registro decorado de todas as 70 ferramentas MCP
│   ├── utils/
│   │   └── logger.py            # Logger estruturado Loguru
│   └── main.py                  # Ponto de entrada do servidor FastMCP
├── logs/                        # Logs de execução da aplicação
├── .env.example                 # Modelo de variáveis de ambiente com dados sanitizados
├── .gitignore                   # Regras de exclusão do Git
├── LICENSE                      # Licença de uso Apache 2.0
├── README.md                    # Documentação técnica oficial e catálogo de ferramentas
├── pyproject.toml               # Metadados do projeto Python
├── requirements.txt             # Dependências diretas do projeto
└── start_mcp.py                 # Script de inicialização stdio para clientes MCP

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • MCP-SOC Middleware

    funphp
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to interact with Splunk SIEM and TheHive SOAR through a unified MCP interface, providing 12 tools for alert triage, case management, and security operations.
    MIT

  • cti-mcp-server

    TopCaver
    F
    license
    Not graded
    quality
    D
    maintenance
    Provides threat intelligence tools like IoC lookups, event backtracking, and IP enrichment via MCP, enabling automated triage and evidence queries.
    1
    -

  • xsiam-mcp

    CoveoSec
    A
    license
    B
    quality
    C
    maintenance
    Exposes the entire Palo Alto Cortex XSIAM REST API (129 operations across 26 categories) as MCP tools, plus composite tools like xql_query for AI agents to search and investigate security data.
    100
    Apache 2.0