Nessus MCP Server

by Cyreslab-AI

15 327 downloads Not rated yet MIT

GitHub

About

# Nessus MCP Server A Model Context Protocol (MCP) server for interacting with the Tenable Nessus vulnerability scanner. This server allows AI assistants to perform vulnerability scanning and analysis through the MCP protocol. ## Features - **Vulnerability Scanning**: Start and monitor vulnerability scans against…

Details

License: MIT

Explore

- Vulnerability Scanning: Start and monitor vulnerability scans against specified targets
- Scan Management: List, track, and retrieve results from vulnerability scans
- Vulnerability Analysis: Search for and get detailed information about specific vulnerabilities
- Mock Mode: Fully functional mock mode for testing without a Nessus API key

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Nessus MCP Server

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "nessus mcp server": {
            "nessus": {
                "command": "node",
                "args": [
                    "/path/to/nessus-mcp-server/build/index.js"
                ],
                "env": {
                    "NESSUS_URL": "https://your-nessus-instance:8834",
                    "NESSUS_ACCESS_KEY": "your-access-key",
                    "NESSUS_SECRET_KEY": "your-secret-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "nessus mcp server": {
            "nessus": {
                "command": "node",
                "args": [
                    "/path/to/nessus-mcp-server/build/index.js"
                ],
                "env": {
                    "NESSUS_URL": "https://your-nessus-instance:8834",
                    "NESSUS_ACCESS_KEY": "your-access-key",
                    "NESSUS_SECRET_KEY": "your-secret-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "nessus mcp server": {
            "nessus": {
                "command": "node",
                "args": [
                    "/path/to/nessus-mcp-server/build/index.js"
                ],
                "env": {
                    "NESSUS_URL": "https://your-nessus-instance:8834",
                    "NESSUS_ACCESS_KEY": "your-access-key",
                    "NESSUS_SECRET_KEY": "your-secret-key"
                }
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "nessus mcp server": {
            "nessus": {
                "command": "node",
                "args": [
                    "/path/to/nessus-mcp-server/build/index.js"
                ],
                "env": {
                    "NESSUS_URL": "https://your-nessus-instance:8834",
                    "NESSUS_ACCESS_KEY": "your-access-key",
                    "NESSUS_SECRET_KEY": "your-secret-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "nessus mcp server": {
            "nessus": {
                "command": "node",
                "args": [
                    "/path/to/nessus-mcp-server/build/index.js"
                ],
                "env": {
                    "NESSUS_URL": "https://your-nessus-instance:8834",
                    "NESSUS_ACCESS_KEY": "your-access-key",
                    "NESSUS_SECRET_KEY": "your-secret-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "nessus mcp server": {
            "nessus": {
                "command": "node",
                "args": [
                    "/path/to/nessus-mcp-server/build/index.js"
                ],
                "env": {
                    "NESSUS_URL": "https://your-nessus-instance:8834",
                    "NESSUS_ACCESS_KEY": "your-access-key",
                    "NESSUS_SECRET_KEY": "your-secret-key"
                }
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "nessus mcp server": {
            "nessus": {
                "command": "node",
                "args": [
                    "/path/to/nessus-mcp-server/build/index.js"
                ],
                "env": {
                    "NESSUS_URL": "https://your-nessus-instance:8834",
                    "NESSUS_ACCESS_KEY": "your-access-key",
                    "NESSUS_SECRET_KEY": "your-secret-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "nessus mcp server": {
            "nessus": {
                "command": "node",
                "args": [
                    "/path/to/nessus-mcp-server/build/index.js"
                ],
                "env": {
                    "NESSUS_URL": "https://your-nessus-instance:8834",
                    "NESSUS_ACCESS_KEY": "your-access-key",
                    "NESSUS_SECRET_KEY": "your-secret-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "nessus mcp server": {
            "nessus": {
                "command": "node",
                "args": [
                    "/path/to/nessus-mcp-server/build/index.js"
                ],
                "env": {
                    "NESSUS_URL": "https://your-nessus-instance:8834",
                    "NESSUS_ACCESS_KEY": "your-access-key",
                    "NESSUS_SECRET_KEY": "your-secret-key"
                }
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "nessus mcp server": {
            "nessus": {
                "command": "node",
                "args": [
                    "/path/to/nessus-mcp-server/build/index.js"
                ],
                "env": {
                    "NESSUS_URL": "https://your-nessus-instance:8834",
                    "NESSUS_ACCESS_KEY": "your-access-key",
                    "NESSUS_SECRET_KEY": "your-secret-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "nessus mcp server": {
            "nessus": {
                "command": "node",
                "args": [
                    "/path/to/nessus-mcp-server/build/index.js"
                ],
                "env": {
                    "NESSUS_URL": "https://your-nessus-instance:8834",
                    "NESSUS_ACCESS_KEY": "your-access-key",
                    "NESSUS_SECRET_KEY": "your-secret-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "nessus mcp server": {
            "nessus": {
                "command": "node",
                "args": [
                    "/path/to/nessus-mcp-server/build/index.js"
                ],
                "env": {
                    "NESSUS_URL": "https://your-nessus-instance:8834",
                    "NESSUS_ACCESS_KEY": "your-access-key",
                    "NESSUS_SECRET_KEY": "your-secret-key"
                }
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "nessus mcp server": {
            "nessus": {
                "command": "node",
                "args": [
                    "/path/to/nessus-mcp-server/build/index.js"
                ],
                "env": {
                    "NESSUS_URL": "https://your-nessus-instance:8834",
                    "NESSUS_ACCESS_KEY": "your-access-key",
                    "NESSUS_SECRET_KEY": "your-secret-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "nessus mcp server": {
            "nessus": {
                "command": "node",
                "args": [
                    "/path/to/nessus-mcp-server/build/index.js"
                ],
                "env": {
                    "NESSUS_URL": "https://your-nessus-instance:8834",
                    "NESSUS_ACCESS_KEY": "your-access-key",
                    "NESSUS_SECRET_KEY": "your-secret-key"
                }
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "nessus mcp server": {
            "nessus": {
                "command": "node",
                "args": [
                    "/path/to/nessus-mcp-server/build/index.js"
                ],
                "env": {
                    "NESSUS_URL": "https://your-nessus-instance:8834",
                    "NESSUS_ACCESS_KEY": "your-access-key",
                    "NESSUS_SECRET_KEY": "your-secret-key"
                }
            }
        }
    }
}

From the repository

- Node.js 16 or higher
- TypeScript (for development)

By default, the server runs in mock mode, which doesn't require a Nessus API key:

node build/index.js

To connect to a real Nessus instance, set the following environment variables:

NESSUS_URL=https://your-nessus-instance:8834
NESSUS_ACCESS_KEY=your-access-key
NESSUS_SECRET_KEY=your-secret-key

Then run the server:

node build/index.js

get_scan_results:
  scan_id: scan-1234567890

`list_scan_templates`

List available Nessus scan templates

`start_scan`

Start a new vulnerability scan against a target

`get_scan_status`

Check the status of a running scan

`get_scan_results`

Get the results of a completed scan

`list_scans`

List all scans and their status

`get_vulnerability_details`

Get detailed information about a specific vulnerability

`search_vulnerabilities`

Search for vulnerabilities by keyword

The server provides the following tools:

| Tool Name | Description |
| --------------------------- | ------------------------------------------------------- |
| list_scan_templates | List available Nessus scan templates |
| start_scan | Start a new vulnerability scan against a target |
| get_scan_status | Check the status of a running scan |
| get_scan_results | Get the results of a completed scan |
| list_scans | List all scans and their status |
| get_vulnerability_details | Get detailed information about a specific vulnerability |
| search_vulnerabilities | Search for vulnerabilities by keyword |

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "nessus mcp server": {
            "nessus": {
                "command": "node",
                "args": [
                    "/path/to/nessus-mcp-server/build/index.js"
                ],
                "env": {
                    "NESSUS_URL": "https://your-nessus-instance:8834",
                    "NESSUS_ACCESS_KEY": "your-access-key",
                    "NESSUS_SECRET_KEY": "your-secret-key"
                }
            }
        }
    }
}

McpServers

{
    "nessus": {
        "command": "node",
        "args": [
            "/path/to/nessus-mcp-server/build/index.js"
        ],
        "env": {
            "NESSUS_URL": "https://your-nessus-instance:8834",
            "NESSUS_ACCESS_KEY": "your-access-key",
            "NESSUS_SECRET_KEY": "your-secret-key"
        }
    }
}

A Model Context Protocol (MCP) server for interacting with the Tenable Nessus vulnerability scanner. This server allows AI assistants to perform vulnerability scanning and analysis through the MCP protocol.

Features

Tools

The server provides the following tools:

Installation

Prerequisites

- Node.js 16 or higher
- TypeScript (for development)

Building from Source

1. Clone the repository:

   git clone https://github.com/Cyreslab-AI/nessus-mcp-server.git
   cd nessus-mcp-server

2. Install dependencies:

   npm install

3. Build the server:

   npm run build

Usage

Running in Mock Mode

By default, the server runs in mock mode, which doesn't require a Nessus API key:

node build/index.js

Running with Nessus API

To connect to a real Nessus instance, set the following environment variables:

NESSUS_URL=https://your-nessus-instance:8834
NESSUS_ACCESS_KEY=your-access-key
NESSUS_SECRET_KEY=your-secret-key

Then run the server:

node build/index.js

Using with Claude for Desktop

To use this server with Claude for Desktop:

1. Edit your Claude for Desktop configuration file:

- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json

2. Add the server configuration:

{
  "mcpServers": {
    "nessus": {
      "command": "node",
      "args": ["/path/to/nessus-mcp-server/build/index.js"],
      "env": {
        "NESSUS_URL": "https://your-nessus-instance:8834",
        "NESSUS_ACCESS_KEY": "your-access-key",
        "NESSUS_SECRET_KEY": "your-secret-key"
      }
    }
  }
}

For mock mode, you can omit the env section.

Example Interactions

Starting a Scan

start_scan:
  target: 192.168.1.1
  scan_type: basic-network-scan

Getting Scan Results

get_scan_results:
  scan_id: scan-1234567890

Searching for Vulnerabilities

search_vulnerabilities:
  keyword: log4j

Development

Project Structure

- src/index.ts: Main server entry point
- src/nessus-api.ts: Nessus API client with mock fallback
- src/mock-data.ts: Mock vulnerability data for testing
- src/tools/: Tool implementations
- src/utils/: Utility functions

Adding New Tools

1. Define the tool schema and handler in the appropriate file in src/tools/
2. Import and register the tool in src/index.ts

License

MIT

Disclaimer

This server is not affiliated with or endorsed by Tenable. Nessus is a trademark of Tenable, Inc.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

From the repository

list_scan_templates

start_scan

get_scan_status

get_scan_results

list_scans

get_vulnerability_details

search_vulnerabilities

Claude Desktop / Cursor

McpServers

Features

Tools

Installation

Prerequisites

Building from Source

Usage

Running in Mock Mode

Running with Nessus API

Using with Claude for Desktop

Example Interactions

Starting a Scan

Getting Scan Results

Searching for Vulnerabilities

Development

Project Structure

Adding New Tools

License

Disclaimer

More like this

Sentry

Github

Git

GitLab

`list_scan_templates`

`start_scan`

`get_scan_status`

`get_scan_results`

`list_scans`

`get_vulnerability_details`

`search_vulnerabilities`