Puppeteer MCP Integration

Guide for integrating web automation capabilities with PraisonAI agents using Puppeteer MCP

Add Puppeteer Tool to AI Agent

Diagram

Query

AI Agent

Puppeteer MCP

Answer

Quick Start

  1. Install Dependencies

    Make sure you have Node.js installed, as the MCP server requires it:

    bash
    pip install praisonaiagents mcp
  2. Set API Key

    Set your OpenAI API key as an environment variable in your terminal:

    bash
    export OPENAI_API_KEY=your_openai_api_key_here
  3. Create a file

    Create a new file puppeteer_agent.py with the following code:

    python
    from praisonaiagents import Agent, MCP
    import os
    
    # Use a single string command with Puppeteer configuration
    puppeteer_agent = Agent(
        instructions="""You are a helpful assistant that can automate web browser interactions.
        Use the available tools when relevant to perform web automation tasks.""",
        llm="gpt-4o-mini",
        tools=MCP("npx -y @modelcontextprotocol/server-puppeteer")
    )
    
    puppeteer_agent.start("Navigate to example.com and take a screenshot")
  4. Run the Agent

    Execute your script:

    bash
    python puppeteer_agent.py