Firefox MCP Server

Instructions

Implementation Reference

• index.js:409-426 (handler)

  The handler function for the 'screenshot' MCP tool. It ensures the browser is running, extracts path and fullPage from arguments (with defaults), calls page.screenshot from Playwright, and returns a text confirmation.

  //   async screenshot(args = {}) {
  //     this.ensureBrowserRunning();
  //     const { path = 'screenshot.png', fullPage = false } = args;
      
  //     await this.page.screenshot({
  //       path,
  //       fullPage
  //     });
      
  //     return {
  //       content: [
  //         {
  //           type: 'text',
  //           text: `Screenshot saved to: ${path}`
  //         }
  //       ]
  //     };
  //   }

• index.js:136-151 (schema)

  The schema definition for the 'screenshot' tool, including name, description, and inputSchema specifying optional path (default 'screenshot.png') and fullPage (default false) parameters.

  //             description: 'Take a screenshot of the current page',
  //             inputSchema: {
  //               type: 'object',
  //               properties: {
  //                 path: {
  //                   type: 'string',
  //                   description: 'File path to save screenshot',
  //                   default: 'screenshot.png'
  //                 },
  //                 fullPage: {
  //                   type: 'boolean',
  //                   description: 'Capture full page',
  //                   default: false
  //                 }
  //               }
  //             }

• index.js:247-248 (registration)

  Registration of the 'screenshot' tool handler in the switch statement within the CallToolRequestSchema request handler.

  //           case 'screenshot':
  //             return await this.screenshot(args);

• index.js:35-226 (registration)

  The listTools response includes the 'screenshot' tool in the tools array (specific block at 135-152). This registers the tool's metadata for MCP clients.

  //         tools: [
  //           {
  //             name: 'launch_firefox',
  //             description: 'Launch Firefox browser',
  //             inputSchema: {
  //               type: 'object',
  //               properties: {
  //                 headless: {
  //                   type: 'boolean',
  //                   description: 'Run browser in headless mode',
  //                   default: false
  //                 },
  //                 url: {
  //                   type: 'string',
  //                   description: 'Initial URL to navigate to',
  //                   default: 'about:blank'
  //                 }
  //               }
  //             }
  //           },
  //           {
  //             name: 'navigate',
  //             description: 'Navigate to a URL',
  //             inputSchema: {
  //               type: 'object',
  //               properties: {
  //                 url: {
  //                   type: 'string',
  //                   description: 'URL to navigate to'
  //                 }
  //               },
  //               required: ['url']
  //             }
  //           },
  //           {
  //             name: 'click',
  //             description: 'Click on an element',
  //             inputSchema: {
  //               type: 'object',
  //               properties: {
  //                 selector: {
  //                   type: 'string',
  //                   description: 'CSS selector or text content to click'
  //                 },
  //                 coordinates: {
  //                   type: 'object',
  //                   properties: {
  //                     x: { type: 'number' },
  //                     y: { type: 'number' }
  //                   },
  //                   description: 'Click at specific coordinates (alternative to selector)'
  //                 }
  //               }
  //             }
  //           },
  //           {
  //             name: 'type_text',
  //             description: 'Type text into an input field',
  //             inputSchema: {
  //               type: 'object',
  //               properties: {
  //                 selector: {
  //                   type: 'string',
  //                   description: 'CSS selector of the input field'
  //                 },
  //                 text: {
  //                   type: 'string',
  //                   description: 'Text to type'
  //                 }
  //               },
  //               required: ['selector', 'text']
  //             }
  //           },
  //           {
  //             name: 'get_page_content',
  //             description: 'Get the HTML content of the current page',
  //             inputSchema: {
  //               type: 'object',
  //               properties: {
  //                 selector: {
  //                   type: 'string',
  //                   description: 'CSS selector to get specific element content (optional)'
  //                 }
  //               }
  //             }
  //           },
  //           {
  //             name: 'get_page_text',
  //             description: 'Get the visible text content of the current page',
  //             inputSchema: {
  //               type: 'object',
  //               properties: {
  //                 selector: {
  //                   type: 'string',
  //                   description: 'CSS selector to get specific element text (optional)'
  //                 }
  //               }
  //             }
  //           },
  //           {
  //             name: 'screenshot',
  //             description: 'Take a screenshot of the current page',
  //             inputSchema: {
  //               type: 'object',
  //               properties: {
  //                 path: {
  //                   type: 'string',
  //                   description: 'File path to save screenshot',
  //                   default: 'screenshot.png'
  //                 },
  //                 fullPage: {
  //                   type: 'boolean',
  //                   description: 'Capture full page',
  //                   default: false
  //                 }
  //               }
  //             }
  //           },
  //           {
  //             name: 'wait_for_element',
  //             description: 'Wait for an element to appear on the page',
  //             inputSchema: {
  //               type: 'object',
  //               properties: {
  //                 selector: {
  //                   type: 'string',
  //                   description: 'CSS selector to wait for'
  //                 },
  //                 timeout: {
  //                   type: 'number',
  //                   description: 'Timeout in milliseconds',
  //                   default: 30000
  //                 }
  //               },
  //               required: ['selector']
  //             }
  //           },
  //           {
  //             name: 'execute_script',
  //             description: 'Execute JavaScript in the browser',
  //             inputSchema: {
  //               type: 'object',
  //               properties: {
  //                 script: {
  //                   type: 'string',
  //                   description: 'JavaScript code to execute'
  //                 }
  //               },
  //               required: ['script']
  //             }
  //           },
  //           {
  //             name: 'close_browser',
  //             description: 'Close the Firefox browser',
  //             inputSchema: {
  //               type: 'object',
  //               properties: {}
  //             }
  //           },
  //           {
  //             name: 'get_current_url',
  //             description: 'Get the current page URL',
  //             inputSchema: {
  //               type: 'object',
  //               properties: {}
  //             }
  //           },
  //           {
  //             name: 'back',
  //             description: 'Navigate back in browser history',
  //             inputSchema: {
  //               type: 'object',
  //               properties: {}
  //             }
  //           },
  //           {
  //             name: 'forward',
  //             description: 'Navigate forward in browser history',
  //             inputSchema: {
  //               type: 'object',
  //               properties: {}
  //             }
  //           },
  //           {
  //             name: 'reload',
  //             description: 'Reload the current page',
  //             inputSchema: {
  //               type: 'object',
  //               properties: {}
  //             }
  //           }
  //         ],

• index.js:533-537 (helper)

  Helper method called by screenshot handler to ensure browser and page are initialized before taking screenshot.

  //   ensureBrowserRunning() {
  //     if (!this.browser || !this.page) {
  //       throw new Error('Firefox browser is not running. Please launch it first using the launch_firefox tool.');
  //     }
  //   }