# MCP Server Malcolm

> MCP Server Malcolm is an open-source MCP server for security. Threat-hunting access to Malcolm's Zeek, Suricata, Arkime and OpenSearch data for agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Linux, macOS, Windows, CLI
- **Repository:** https://github.com/nagametw/mcp-server-malcolm
- **MCP Registry name:** io.github.nagameTW/mcp-server-malcolm
- **Categories:** [security](https://ai-powered.com/categories/security)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-server-malcolm -- uvx mcp-server-malcolm
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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)

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [AiSOC](https://ai-powered.com/mcp/aisoc): AiSOC is an open-source MCP server for ai models and llm tooling.
- [redamon](https://ai-powered.com/mcp/redamon): redamon is an open-source MCP server for ai models and llm tooling.
- [x64dbg-mcp-server](https://ai-powered.com/mcp/x64dbg-mcp-server): x64dbg-mcp-server is an open-source MCP server for ai models and llm tooling.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Cisa Kev](https://ai-powered.com/mcp/cisa-kev): Cisa Kev is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/mcp-server-malcolm
