Burpsuite MCP Server

Instructions

Implementation Reference

• src/index.ts:593-635 (handler)

  The handler for the 'get_proxy_history' tool. It extracts optional filter parameters (host, method, status_code, limit) from the arguments, filters the mockProxyHistory array accordingly, and returns a JSON-formatted text content with summary of matching items including id, host, method, url, status_code, time, size, and mime_type.

  case "get_proxy_history": {
    const host = request.params.arguments?.host as string | undefined;
    const method = request.params.arguments?.method as string | undefined;
    const statusCode = request.params.arguments?.status_code as number | undefined;
    const limit = Number(request.params.arguments?.limit || 10);
  
    let history = [...mockProxyHistory];
  
    // Apply filters
    if (host) {
      history = history.filter(item => item.host.includes(host));
    }
  
    if (method) {
      history = history.filter(item => item.method === method.toUpperCase());
    }
  
    if (statusCode) {
      history = history.filter(item => item.statusCode === statusCode);
    }
  
    // Apply limit
    history = history.slice(0, limit);
  
    return {
      content: [{
        type: "text",
        text: JSON.stringify({
          total_items: history.length,
          items: history.map(item => ({
            id: item.id,
            host: item.host,
            method: item.method,
            url: item.url,
            status_code: item.statusCode,
            time: item.time,
            size: item.size,
            mime_type: item.mimeType
          }))
        }, null, 2)
      }]
    };
  }

• src/index.ts:435-458 (registration)

  Registration of the 'get_proxy_history' tool in the ListToolsRequestSchema handler, including its name, description, and inputSchema defining optional parameters for filtering proxy history.

    name: "get_proxy_history",
    description: "Get HTTP/HTTPS traffic captured by Burp Proxy",
    inputSchema: {
      type: "object",
      properties: {
        host: {
          type: "string",
          description: "Filter by host (optional)"
        },
        method: {
          type: "string",
          description: "Filter by HTTP method (optional)"
        },
        status_code: {
          type: "number",
          description: "Filter by HTTP status code (optional)"
        },
        limit: {
          type: "number",
          description: "Maximum number of items to return (default: 10)"
        }
      }
    }
  },

• src/index.ts:59-70 (schema)

  TypeScript interface defining the structure of ProxyHistoryItem, used for typing the mock data and implicitly the tool's data handling.

  interface ProxyHistoryItem {
    id: string;
    host: string;
    method: string;
    url: string;
    statusCode: number;
    request: string;
    response: string;
    time: string;
    size: number;
    mimeType: string;
  }