gbrigandi/mcp-server-cortex

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

17 stars 8 forks Качество 63 Тренд 21MIT

Repository Install

MCP сервер для Cortex

Обзор

Этот сервер действует как мост, раскрывая мощные аналитические возможности экземпляра Cortex в качестве инструментов, используемых клиентами протокола Model Context Protocol (MCP), таких как большие языковые модели, такие как Claude. Это позволяет этим клиентам использовать анализаторы Cortex для задач разведки угроз. Cortex - это мощный, бесплатный и открытый механизм анализа и активного реагирования. Он позволяет анализировать наблюдаемые объекты (например, IP-адреса, URL-адреса, домены, файлы и т.д.) с помощью различных «анализаторов» - модульных фрагментов кода, которые подключаются к внешним службам или выполняют локальный анализ. • Проводить различные анализы из одной точки. Легко добавить новые анализаторы для различных каналов и инструментов разведки угроз. Автоматизировать процесс обогащения наблюдаемых. Предназначен для тесной работы с TheHive, платформой реагирования на инциденты безопасности (SIRP), но также может использоваться автономно. *: API-ключ для защиты вашего экземпляра Cortex.

Обзор (машинный перевод)

Что такое кортекс?

Cortex - это мощный, бесплатный и открытый механизм анализа и активного реагирования. Он позволяет анализировать наблюдаемые объекты (например, IP-адреса, URL-адреса, домены, файлы и т.д.) с помощью различных «анализаторов» - модульных фрагментов кода, которые подключаются к внешним службам или выполняют локальный анализ.

Преимущества использования Cortex (и этого MCP-сервера):

** Централизованный анализ**: Проведение различных анализов из одной точки. Расширяемость: легко добавлять новые анализаторы для различных каналов и инструментов разведки угроз. Автоматизация: Автоматизация процесса обогащения наблюдаемых объектов. Интеграция: разработана для тесного сотрудничества с TheHive, платформой реагирования на инциденты безопасности (SIRP), но также может использоваться автономно. Безопасность: API-ключевой доступ для защиты вашего экземпляра Cortex.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

MCP Server for Cortex

This server acts as a bridge, exposing the powerful analysis capabilities of a Cortex instance as tools consumable by Model Context Protocol (MCP) clients, such as large language models like Claude. It allows these clients to leverage Cortex analyzers for threat intelligence tasks.

What is Cortex?

Cortex is a powerful, free, and open-source observable analysis and active response engine. It allows you to analyze observables (like IPs, URLs, domains, files, etc.) using a variety of “analyzers” – modular pieces of code that connect to external services or perform local analysis.

Benefits of using Cortex (and this MCP server):

Centralized Analysis: Run various analyses from a single point.
Extensibility: Easily add new analyzers for different threat intelligence feeds and tools.
Automation: Automate the process of enriching observables.
Integration: Designed to work closely with TheHive, a Security Incident Response Platform (SIRP), but can also be used standalone.
Security: API-key based access to protect your Cortex instance.

This MCP server makes these benefits accessible to MCP-compatible clients, enabling them to request analyses and receive structured results.

Prerequisites

Rust Toolchain: Ensure you have Rust installed (visit rustup.rs).
Cortex Instance: A running Cortex instance is required.
- The server needs network access to this Cortex instance.
- An API key for Cortex with permissions to list analyzers and run jobs.
Configured Analyzers: The specific analyzers you intend to use (e.g., AbuseIPDB_1_0, Abuse_Finder_3_0, VirusTotal_Scan_3_1, Urlscan_io_Scan_0_1_0) must be enabled and correctly configured within your Cortex instance.

Installation

The recommended way to install the MCP Server for Cortex is to download a pre-compiled binary for your operating system.

Go to the Releases Page: Navigate to the GitHub Releases page.
Download the Binary: Find the latest release and download the appropriate binary for your operating system (e.g., mcp-server-cortex-linux-amd64, mcp-server-cortex-macos-amd64, mcp-server-cortex-windows-amd64.exe).
Place and Prepare the Binary:
- Move the downloaded binary to a suitable location on your system (e.g., /usr/local/bin on Linux/macOS, or a dedicated folder like C:\Program Files\MCP Servers\ on Windows).
- For Linux/macOS: Make the binary executable:
```
chmod +x /path/to/your/mcp-server-cortex
```
- Ensure the directory containing the binary is in your system’s PATH if you want to run it without specifying the full path.

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
          "mcpServers": {
            // ... other server configurations ...
            "cortex": {
              "command": "/opt/mcp-servers/mcp-server-cortex",
              "args": [],
              "env": {
                "CORTEX_ENDPOINT": "http://your-cortex-instance:9000/api",
                "CORTEX_API_KEY": "your_cortex_api_key_here",
              }
            }
            // ... other server configurations ...
          }
        }


## Available Tools

The server provides the following tools, which can be called by an MCP client:

1.  **`analyze_ip_with_abuseipdb`**
    *   **Description**: Analyzes an IP address using an AbuseIPDB analyzer (or a similarly configured IP reputation analyzer) via Cortex. Returns the job report if successful.
    *   **Parameters**:
        *   `ip` (string, required): The IP address to analyze.
        *   `analyzer_name` (string, optional): The specific name of the AbuseIPDB analyzer instance in Cortex. Defaults to `AbuseIPDB_1_0`.
        *   `max_retries` (integer, optional): Maximum number of times to poll for the analyzer job to complete. Defaults to 5.

2.  **`analyze_with_abusefinder`**
    *   **Description**: Analyzes various types of data (IP, domain, FQDN, URL, or email) using an AbuseFinder analyzer via Cortex. Returns the job report if successful.
    *   **Parameters**:
        *   `data` (string, required): The data to analyze (e.g., "1.1.1.1", "example.com", "http://evil.com/malware", "[email protected]").
   
…