Skip to content
MCP server

MCP Server Malcolm

Threat-hunting access to Malcolm's Zeek, Suricata, Arkime and OpenSearch data for agents

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
Linux, macOS, Windows
Runs
Locally
Version
1.2.1
Listing updated
today

Similar MCP servers

About MCP Server Malcolm

MCP Server Malcolm is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

The server connects an agent to an existing Malcolm network-traffic analysis instance over HTTPS, using Malcolm's own field names and filter syntax so the agent does not have to guess them. It runs locally over stdio with Python 3.11 or newer and authenticates with Basic auth settings supplied through environment variables.

It registers 51 read tools covering filter queries, aggregations, field lookup, Arkime sessions and packets, NetBox, Zeek file scans, saved objects and alerting monitors. Example requests in the README include Suricata alerts for an IP and the NetBox device that owns it, top talkers by protocol, and executables carved by Zeek with their hashes. The tool schemas cost about 34,000 tokens per session, and read groups can be switched off to trim that.

Writing is off by default. Five write classes (alerting, Arkime tags, hunt jobs, PCAP upload and Arkime views) each need their own flag, are not listed until enabled and log an audit line per attempt. Destructive actions and raw OpenSearch or NetBox writes are deliberately left out.

Install

Run in a terminal

claude mcp add mcp-server-malcolm -- uvx mcp-server-malcolm

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server-malcolm": {
      "command": "uvx",
      "args": [
        "mcp-server-malcolm"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server-malcolm": {
      "command": "uvx",
      "args": [
        "mcp-server-malcolm"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-server-malcolm": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-server-malcolm"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server-malcolm": {
      "command": "uvx",
      "args": [
        "mcp-server-malcolm"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-server-malcolm": {
      "command": "uvx",
      "args": [
        "mcp-server-malcolm"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (12)

Taken from the project documentation; the running server may differ.

malcolm_ping
Checks the connection to Malcolm
malcolm_alerts
Returns Suricata alerts
malcolm_netbox_lookup
Looks up the NetBox device that owns an IP
malcolm_aggregate
Aggregates traffic such as top talkers by protocol
malcolm_file_scans
Lists files Zeek carved out of traffic with hashes
malcolm_upload_pcap
Uploads a PCAP (write, off by default)
arkime_create_hunt
Creates a packet hunt job (write, off by default)
arkime_cancel_hunt
Cancels a hunt job (write, off by default)
malcolm_create_alert
Creates an alert (write, off by default)
arkime_add_tags
Adds Arkime tags (write, off by default)
arkime_create_view
Creates an Arkime view (write, off by default)
arkime_create_shortcut
Creates an Arkime shortcut (write, off by default)

What it does

Native Malcolm syntax
Uses Malcolm's field names and filters so queries are not guessed.
51 read tools
Covers queries, aggregations, Arkime sessions, NetBox, Zeek file scans and alerting monitors.
Read-only default
Write classes are not registered until each flag is set.
Audit logging
Every write attempt writes one audit line to stderr or a file.
Token trimming
Read groups can be disabled to cut the tool schema size.
Container option
Docs describe a container image and other install routes.

Good for

  • Investigate Suricata alerts involving a suspicious IP
  • Find top talkers by protocol over a time window
  • List files Zeek extracted from traffic with hashes
  • Upload a PCAP and hunt stored packets for a string

Pricing

Open source

Free, MIT licensed; requires an existing Malcolm instance

MCP Server Malcolm FAQ

Does it change my Malcolm data?

Not by default; only read tools are registered until you enable write-class flags.

What does it need?

Python 3.11 or newer, a Malcolm instance reachable over HTTPS with API access and an MCP client.

How do I handle Malcolm's self-signed certificate?

Point the SSL verify setting at a CA bundle whose certificate has a matching subjectAltName; use false only on an isolated lab machine.

Does it support remote HTTP transport?

No, version 1 is stdio only.

Is MCP Server Malcolm free?

Yes. MCP Server Malcolm is open source, so you can use and self-host it for free.

How do I add MCP Server Malcolm to Claude Code?

Run this command in your terminal: claude mcp add mcp-server-malcolm -- uvx mcp-server-malcolm

What are the best alternatives to MCP Server Malcolm?

The closest alternatives to MCP Server Malcolm are REA, AiSOC, redamon, x64dbg-mcp-server and Agent Roast.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers