proxy_start_server
Start an HTTP/HTTPS proxy server for traffic monitoring and analysis, with optional SSL bumping to intercept encrypted connections.
Instructions
Start the proxy server with optional SSL bumping
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| port | No | Port to run proxy server on | |
| host | No | Host to bind proxy server to | localhost |
| enableSSLBumping | No | Enable SSL bumping for HTTPS traffic interception |
Implementation Reference
- src/tools/tool-handlers.js:223-244 (handler)Executes the proxy_start_server tool: checks if server is running, starts proxy server with specified port, host, and SSL bumping option, returns detailed status including PAC URL and CA certificate info.
case 'proxy_start_server': if (this.proxyServer.isRunning()) { return { content: [{ type: "text", text: `Proxy server is already running on ${this.proxyServer.getAddress()}` }] }; } await this.proxyServer.start(args.port, args.host, { enableSSLBumping: args.enableSSLBumping }); const serverStatus = this.proxyServer.getStatus(); return { content: [{ type: "text", text: `š Proxy server started!\n\nAddress: ${this.proxyServer.getAddress()}\nPAC URL: ${this.proxyServer.getAddress()}/proxy.pac\nCA Certificate: ${this.proxyServer.getAddress()}/ca.crt\nSSL Bumping: ${serverStatus.sslBumpingEnabled ? 'ENABLED' : 'DISABLED'}\nMonitoring: ${this.targetManager.getStats().enabled} domains${serverStatus.sslBumpingEnabled ? '\n\nā ļø SSL Bumping is active - install CA certificate for HTTPS interception!' : ''}` }] }; - Defines the input schema and description for the proxy_start_server tool, specifying optional parameters for port, host, and SSL bumping.
proxy_start_server: { name: "proxy_start_server", description: "Start the proxy server with optional SSL bumping", inputSchema: { type: "object", properties: { port: { type: "number", description: "Port to run proxy server on", default: 8080 }, host: { type: "string", description: "Host to bind proxy server to", default: "localhost" }, enableSSLBumping: { type: "boolean", description: "Enable SSL bumping for HTTPS traffic interception", default: false } } } }, - index.js:66-74 (registration)Registers all tools including proxy_start_server by providing their schemas and descriptions in response to ListToolsRequest in the MCP server.
this.server.setRequestHandler(ListToolsRequestSchema, async () => { return { tools: Object.entries(TOOLS).map(([name, tool]) => ({ name, description: tool.description, inputSchema: tool.inputSchema })) }; });