MISP MCP SERVER

An MCP server integrated with the MISP platform, providing threat intelligence capabilities for large language models, including malware detection, threat intelligence search, IoC submission, and report generation.

Security Developer tools #Threat Intelligence #Malware Detection #MISP Integration #Security Analysis .Python

rating : 2 points

downloads : 8.6K

update time : 2025-04-29

Open Site

What is MISP MCP Server?

The MISP MCP Server is a specialized service that connects your security tools with AI assistants. It allows Claude and other LLMs to access real-time threat intelligence from your MISP (Malware Information Sharing Platform) instance, enabling smarter security analysis and malware detection.

How to use MISP MCP Server?

After installation and configuration, you can simply ask your AI assistant security-related questions. The server will automatically query your MISP database and return the latest threat intelligence in an easy-to-understand format.

Use Cases

Ideal for security teams wanting to: 1) Quickly check for new malware threats 2) Investigate suspicious files or URLs 3) Generate threat reports 4) Submit new security findings directly from chat

Key Features

Mac Malware Detection

Get the latest macOS-related malware samples with details about their behavior and indicators

Cross-Platform Threat Intelligence

Search for threats affecting Windows, macOS, Linux, Android, iOS and IoT devices

Advanced Search

Find threats by type, tag, threat actor or classification level (TLP)

IoC Submission

Submit new Indicators of Compromise directly from chat to your MISP instance

Threat Intelligence Reports

Generate comprehensive security reports based on your MISP data

Advantages

Real-time access to your organization's threat intelligence

No need to manually query MISP - get answers through natural language

Reduces investigation time for security analysts

Easy submission of new security findings directly from chat

Limitations

Requires existing MISP instance and API access

Limited to the data available in your MISP instance

Needs proper configuration for optimal performance

Getting Started

Install the Server

Set up the server on a machine that can access your MISP instance

Configure Connection

Set the required environment variables to connect to your MISP instance

Connect to Claude

Configure Claude Desktop to use the MISP MCP server by editing the configuration file

Example Queries

Check for Mac Malware

Ask about recent macOS malware samples found in your organization's threat database

Investigate Suspicious File

Check if a file hash is known to be malicious

Submit New Finding

Report a new suspicious file found during investigation

Frequently Asked Questions

What permissions does the API key need?

Can I use this with cloud MISP instances?

How recent is the threat data?

Is my data sent to external servers?

Additional Resources

MISP Project

Official MISP threat sharing platform website

MCP Protocol

Model Context Protocol documentation

Installation Guide

Detailed installation instructions

🚀 MISP MCP Server

An MCP (Model Context Protocol) server integrated into the Malware Information Sharing Platform (MISP), providing threat intelligence capabilities for large language models.

🚀 Quick Start

The MISP MCP Server is designed to integrate with MISP and offer threat intelligence features for large language models. Below is a guide on how to get started.

✨ Features

Mac Malware Detection: Find the latest macOS-related malware samples.
Cross-Platform Threat Intelligence: Look for threats affecting Windows, macOS, Linux, Android, iOS, and IoT devices.
Advanced Search Functionality: Search by attribute type, tag, threat actor, or TLP classification.
IoC Submission: Directly submit new Indicators of Compromise (IoCs) to your MISP instance.
Threat Intelligence Reporting: Generate comprehensive reports based on MISP data.
MISP Statistics: Obtain an overview of the data in your MISP instance.

📦 Installation

Prerequisites

Python 3.10 or higher.
A MISP instance with API access.
An API key with appropriate permissions.

Steps

Clone this repository:

git clone https://github.com/your-repository.git

Navigate to the project directory:

cd misp-mcp-server

Install the dependencies:

pip install -r requirements.txt

📚 Documentation

Configuration

Add the following environment variables to your system:

MISP_BASE_URL: The base URL of your MISP instance (e.g., https://misp.example.com).
MISP_API_KEY: The key used to communicate with the MISP API.
MISP_LISTEN_ADDRESS: The address the server will listen on (default is 0.0.0.0).
MISP_LISTEN_PORT: The port the server will use (default is 5000).

Usage

Basic Commands

Start the server:

python3 server.py

Stop the server:

Ctrl+C

Reload the configuration:

.reload

Advanced Usage

Submit IoC

Use the following command to submit an IoC to MISP:

submit_ioc --ioc_value 1a2b3c4d5e6f7g8h9i0j --ioc_type md5 --description "Suspicious file found in a phishing email"

Generate Threat Report

Generate a threat intelligence report containing data from the past month:

generate_threat_report --days 30

Example Queries (Used in combination with Claude)

"What are the recent Mac-related malware samples?"
"Show Windows malware from the past two weeks."
"Search for CVE-2023-12345 in MISP."
"Submit this IoC to MISP: 1a2b3c4d5e6f7g8h9i0j, type md5, description 'Suspicious file found in a phishing email'."
"Generate a threat intelligence report for the past month."
"What are the current MISP statistics?"
"Get the latest MISP source data."
"Perform an advanced search for banking Trojans related to TLP:RED events."