Reports MCP Server

A Model Context Protocol (MCP) server for managing penetration testing reports and vulnerabilities. This server provides tools to create, read, update, and delete reports and vulnerabilities through a REST API.

Features

• Report Management: Create, retrieve, update, and list penetration testing reports

• Vulnerability Management: Add, modify, and delete vulnerabilities within reports

• CVSS Support: Full CVSS 3.1 scoring and vector string support

• HTML Formatting: Automatic formatting of text content to HTML

• JWT Authentication: Secure API access with configurable authentication

Prerequisites

1. Install Node.js

Download and install Node.js (version 18 or higher) from nodejs.org.

On macOS:

On Windows:

• Download the installer from nodejs.org

• Run the installer and follow the setup wizard

On Linux:

2. Verify Installation

Installation

1. Clone this Repository

2. Install Dependencies

This will install:

• @modelcontextprotocol/sdk: The MCP SDK for Node.js

• axios: HTTP client for making API requests

3. Test the Server

You should see:

Press Ctrl+C to stop the server.

Configuration

1. Get Your JWT Token

Obtain your JWT authentication token from your reports API system.

2. Configure Claude Desktop

Add the server to your Claude Desktop MCP configuration file:

Location of config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Configuration:

Important Notes:

• Replace /full/path/to/your/mcp-reports-server/server.js with the actual full path to your server.js file

• Replace your_actual_jwt_token_here with your real JWT token

• Use forward slashes / in paths, even on Windows

Example paths:

• macOS: /Users/username/reports-mcp-server/server.js

• Windows: C:/Users/username/reports-mcp-server/server.js

3. Restart Claude Desktop

Close and reopen Claude Desktop for the configuration to take effect.