puppeteer-mcp-claude 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 jaenster
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,279 @@
+# MCP Puppeteer Server
+
+A Model Context Protocol (MCP) server that provides Claude Code with comprehensive browser automation capabilities through Puppeteer. This server allows Claude to interact with web pages, take screenshots, execute JavaScript, and perform various browser automation tasks.
+
+## Features
+
+- **Browser Management**: Launch and close Chrome/Chromium browsers
+- **Page Operations**: Create, navigate, and manage multiple browser tabs
+- **Element Interaction**: Click, type, and extract text from web elements
+- **JavaScript Execution**: Run custom JavaScript code in the browser context
+- **Screenshot Capture**: Take full-page or viewport screenshots
+- **Selector Waiting**: Wait for elements to appear with configurable timeouts
+- **Multi-page Support**: Manage multiple browser tabs simultaneously
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `puppeteer_launch` | Launch a new browser instance |
+| `puppeteer_new_page` | Create a new browser tab |
+| `puppeteer_navigate` | Navigate to a URL |
+| `puppeteer_click` | Click on an element |
+| `puppeteer_type` | Type text into an input field |
+| `puppeteer_get_text` | Extract text from an element |
+| `puppeteer_screenshot` | Take a screenshot |
+| `puppeteer_evaluate` | Execute JavaScript code |
+| `puppeteer_wait_for_selector` | Wait for an element to appear |
+| `puppeteer_close_page` | Close a specific tab |
+| `puppeteer_close_browser` | Close the entire browser |
+
+## Installation
+
+### Quick Install (Recommended)
+
+Install and configure for Claude Code in one command:
+
+```bash
+npx puppeteer-mcp-claude install
+```
+
+That's it! The installer will:
+- Download and install the package
+- Automatically configure Claude Code
+- Verify the installation
+- Provide next steps
+
+### Manual Installation
+
+If you prefer to install manually:
+
+1. **Install the package globally**:
+   ```bash
+   npm install -g puppeteer-mcp-claude
+   ```
+
+2. **Configure for Claude Code**:
+   ```bash
+   puppeteer-mcp-claude install
+   ```
+
+### Development Installation
+
+For development or contribution:
+
+1. **Clone and install dependencies**:
+   ```bash
+   git clone https://github.com/jaenster/puppeteer-mcp-claude.git
+   cd puppeteer-mcp-claude
+   npm install
+   ```
+
+2. **Build the project**:
+   ```bash
+   npm run build
+   ```
+
+3. **Use local setup script**:
+   ```bash
+   npm run setup-mcp
+   ```
+
+## Management Commands
+
+| Command | Description |
+|---------|-------------|
+| `npx puppeteer-mcp-claude install` | Install and configure for Claude Code |
+| `npx puppeteer-mcp-claude uninstall` | Remove from Claude Code |
+| `npx puppeteer-mcp-claude status` | Check installation status |
+| `npx puppeteer-mcp-claude help` | Show help and available tools |
+
+## Alternative Installation Methods
+
+### Method 1: Using Claude Code MCP Command
+
+You can also configure this server using Claude Code's built-in MCP management:
+
+```bash
+claude mcp add puppeteer-mcp-claude
+```
+
+### Method 2: Manual Configuration
+
+Create or edit `~/.claude/claude_desktop_config.json`:
+```json
+{
+  "mcpServers": {
+    "puppeteer-mcp-claude": {
+      "command": "npx",
+      "args": ["puppeteer-mcp-claude", "serve"],
+      "env": {
+        "NODE_ENV": "production"
+      }
+    }
+  }
+}
+```
+
+## Post-Installation Steps
+
+1. **Restart Claude Code** if it's currently running
+2. **Test the integration**:
+   ```bash
+   npm run test:integration
+   ```
+3. **Verify in Claude Code** by asking: "List all available tools"
+
+You should see the Puppeteer tools listed among the available tools.
+
+## Usage Examples
+
+### Basic Web Automation
+```javascript
+// Launch browser
+await puppeteer_launch({ headless: false });
+
+// Create a new page
+await puppeteer_new_page({ pageId: "main" });
+
+// Navigate to a website
+await puppeteer_navigate({ 
+  pageId: "main", 
+  url: "https://example.com" 
+});
+
+// Take a screenshot
+await puppeteer_screenshot({ 
+  pageId: "main", 
+  path: "screenshot.png" 
+});
+```
+
+### Form Interaction
+```javascript
+// Type into a search field
+await puppeteer_type({ 
+  pageId: "main", 
+  selector: "input[name='search']", 
+  text: "Claude AI" 
+});
+
+// Click a button
+await puppeteer_click({ 
+  pageId: "main", 
+  selector: "button[type='submit']" 
+});
+
+// Wait for results to load
+await puppeteer_wait_for_selector({ 
+  pageId: "main", 
+  selector: ".search-results" 
+});
+```
+
+### Data Extraction
+```javascript
+// Extract text from an element
+await puppeteer_get_text({ 
+  pageId: "main", 
+  selector: "h1" 
+});
+
+// Execute custom JavaScript
+await puppeteer_evaluate({ 
+  pageId: "main", 
+  script: "document.querySelectorAll('a').length" 
+});
+```
+
+## Configuration Options
+
+### Browser Launch Options
+- `headless`: Run browser in headless mode (default: true)
+- `args`: Array of Chrome arguments (e.g., `["--disable-web-security"]`)
+
+### Navigation Options
+- `waitUntil`: Wait condition for navigation
+  - `load`: Wait for load event
+  - `domcontentloaded`: Wait for DOM content loaded
+  - `networkidle0`: Wait for no network activity
+  - `networkidle2`: Wait for max 2 network connections
+
+### Screenshot Options
+- `path`: File path to save screenshot
+- `fullPage`: Capture full page scroll height (default: false)
+
+## Management Commands
+
+| Command | Description |
+|---------|-------------|
+| `npm run setup-mcp` | Automatically configure MCP server |
+| `npm run remove-mcp` | Remove MCP server configuration |
+| `npm run status-mcp` | Check current configuration status |
+| `npm run test:integration` | Test the MCP server integration |
+
+## Troubleshooting
+
+### Common Issues
+
+1. **Claude Code doesn't see the tools**:
+   - Ensure Claude Code is restarted after configuration
+   - Check that the path in `claude_desktop_config.json` is correct
+   - Verify the MCP server is configured properly with `npm run status-mcp`
+
+2. **"Browser not launched" errors**:
+   - Always call `puppeteer_launch` before using other tools
+   - Make sure the browser launch was successful
+
+3. **Element not found errors**:
+   - Use `puppeteer_wait_for_selector` before interacting with elements
+   - Verify selectors are correct using browser developer tools
+
+4. **Permission errors**:
+   - Make sure the project directory has proper permissions
+   - Check that `ts-node` is installed and accessible
+
+### Debug Mode
+
+For debugging, you can run the server in development mode:
+```bash
+npm run dev
+```
+
+This will show detailed logs of all MCP operations.
+
+### Testing
+
+Run the test suite to verify everything is working:
+```bash
+npm test
+```
+
+For integration testing with Claude Code:
+```bash
+npm run test:integration
+```
+
+## Security Considerations
+
+- The server runs with the same permissions as the user
+- Browser instances are automatically cleaned up on exit
+- All JavaScript execution happens in the browser context, not the Node.js process
+- Network requests are subject to the same security policies as a regular Chrome browser
+
+## Requirements
+
+- Node.js 16 or higher
+- Chrome/Chromium browser (automatically downloaded by Puppeteer)
+- Claude Code with MCP support
+- TypeScript support (`ts-node`)
+
+## Support
+
+If you encounter issues:
+1. Check the troubleshooting section above
+2. Verify your configuration with `npm run status-mcp`
+3. Run the integration tests with `npm run test:integration`
+4. Check Claude Code logs for MCP-related errors
+
+For additional help, refer to the [Claude Code MCP documentation](https://docs.anthropic.com/en/docs/claude-code/mcp).

package/bin/cli.js

@@ -0,0 +1,326 @@
+#!/usr/bin/env node
+
+const { execSync, spawn } = require('child_process');
+const { readFileSync, writeFileSync, existsSync, mkdirSync } = require('fs');
+const { join } = require('path');
+const { homedir } = require('os');
+const path = require('path');
+
+class PuppeteerMCPInstaller {
+  constructor() {
+    this.packageDir = path.dirname(__dirname);
+    this.claudeConfigPath = join(homedir(), '.claude', 'claude_desktop_config.json');
+    this.serverName = 'puppeteer-mcp-claude';
+  }
+
+  async install() {
+    console.log('🚀 Installing Puppeteer MCP Claude...\n');
+
+    try {
+      await this.ensureClaudeDirectory();
+      await this.updateClaudeConfig();
+      await this.verifyInstallation();
+      
+      console.log('\n✅ Puppeteer MCP Claude installed successfully!');
+      console.log('\n📋 Next steps:');
+      console.log('   1. Restart Claude Code if it\'s running');
+      console.log('   2. In Claude Code, ask: "List all available tools"');
+      console.log('   3. You should see puppeteer tools listed');
+      console.log('\n🔧 Management commands:');
+      console.log('   npx puppeteer-mcp-claude uninstall  # Remove from Claude Code');
+      console.log('   npx puppeteer-mcp-claude status     # Check installation status');
+      console.log('\n📖 Documentation: https://github.com/jaenster/puppeteer-mcp-claude');
+      
+    } catch (error) {
+      console.error('❌ Installation failed:', error.message);
+      process.exit(1);
+    }
+  }
+
+  async uninstall() {
+    console.log('🗑️  Uninstalling Puppeteer MCP Claude...\n');
+    
+    if (!existsSync(this.claudeConfigPath)) {
+      console.log('⚠️  No Claude Code configuration found');
+      return;
+    }
+
+    try {
+      const configContent = readFileSync(this.claudeConfigPath, 'utf8');
+      const config = JSON.parse(configContent);
+      
+      if (config.mcpServers?.[this.serverName]) {
+        delete config.mcpServers[this.serverName];
+        writeFileSync(this.claudeConfigPath, JSON.stringify(config, null, 2));
+        console.log('✅ Puppeteer MCP Claude removed from Claude Code configuration');
+        console.log('   Restart Claude Code to complete removal');
+      } else {
+        console.log('⚠️  Puppeteer MCP Claude was not found in configuration');
+      }
+    } catch (error) {
+      console.error('❌ Failed to remove configuration:', error.message);
+    }
+  }
+
+  async status() {
+    console.log('📊 Puppeteer MCP Claude Status\n');
+    
+    if (!existsSync(this.claudeConfigPath)) {
+      console.log('❌ No Claude Code configuration found');
+      console.log('   Run: npx puppeteer-mcp-claude install');
+      return;
+    }
+
+    try {
+      const configContent = readFileSync(this.claudeConfigPath, 'utf8');
+      const config = JSON.parse(configContent);
+      
+      if (config.mcpServers?.[this.serverName]) {
+        console.log('✅ Puppeteer MCP Claude is installed');
+        console.log('\n📋 Configuration:');
+        const serverConfig = config.mcpServers[this.serverName];
+        console.log(`   Command: ${serverConfig.command}`);
+        console.log(`   Args: ${serverConfig.args?.join(' ') || 'none'}`);
+        console.log(`   Working Directory: ${serverConfig.cwd || 'not set'}`);
+        console.log(`   Environment: ${JSON.stringify(serverConfig.env || {})}`);
+        
+        // Check if the server executable exists
+        if (serverConfig.cwd && existsSync(join(serverConfig.cwd, 'dist', 'index.js'))) {
+          console.log('✅ Server executable found');
+        } else {
+          console.log('⚠️  Server executable not found - may need to rebuild');
+        }
+      } else {
+        console.log('❌ Puppeteer MCP Claude is not installed');
+        console.log('   Run: npx puppeteer-mcp-claude install');
+      }
+      
+      // Show all MCP servers
+      if (config.mcpServers && Object.keys(config.mcpServers).length > 0) {
+        console.log('\n📋 All configured MCP servers:');
+        Object.keys(config.mcpServers).forEach(serverName => {
+          const isOurs = serverName === this.serverName ? ' ← (this package)' : '';
+          console.log(`   • ${serverName}${isOurs}`);
+        });
+      }
+      
+    } catch (error) {
+      console.error('❌ Failed to read configuration:', error.message);
+    }
+  }
+
+  async ensureClaudeDirectory() {
+    const claudeDir = join(homedir(), '.claude');
+    
+    if (!existsSync(claudeDir)) {
+      console.log('📁 Creating .claude directory...');
+      mkdirSync(claudeDir, { recursive: true });
+    }
+    
+    console.log('✅ Claude directory ready');
+  }
+
+  async updateClaudeConfig() {
+    console.log('📝 Updating Claude Code configuration...');
+    
+    let config = {};
+    let hasExistingConfig = false;
+
+    // Read existing config if it exists
+    if (existsSync(this.claudeConfigPath)) {
+      try {
+        const configContent = readFileSync(this.claudeConfigPath, 'utf8');
+        config = JSON.parse(configContent);
+        hasExistingConfig = true;
+        console.log('📖 Found existing configuration');
+      } catch (error) {
+        console.log('⚠️  Could not parse existing config, creating new one');
+        config = {};
+      }
+    }
+
+    // Initialize mcpServers if it doesn't exist
+    if (!config.mcpServers) {
+      config.mcpServers = {};
+    }
+
+    // Check if server already exists
+    if (config.mcpServers[this.serverName]) {
+      console.log('⚠️  Puppeteer MCP Claude already configured');
+      console.log('   Updating existing configuration...');
+    }
+
+    // Get the globally installed package location
+    const globalPackageDir = this.getGlobalPackageDir();
+
+    // Add/update our MCP server configuration
+    config.mcpServers[this.serverName] = {
+      command: 'npx',
+      args: ['puppeteer-mcp-claude', 'serve'],
+      env: {
+        NODE_ENV: 'production'
+      }
+    };
+
+    // Write the updated configuration
+    writeFileSync(this.claudeConfigPath, JSON.stringify(config, null, 2));
+    
+    if (hasExistingConfig) {
+      console.log('✅ Configuration updated');
+    } else {
+      console.log('✅ Configuration created');
+    }
+  }
+
+  getGlobalPackageDir() {
+    try {
+      // Try to get the package directory from npm
+      const npmRoot = execSync('npm root -g', { encoding: 'utf8' }).trim();
+      const packagePath = join(npmRoot, 'puppeteer-mcp-claude');
+      
+      if (existsSync(packagePath)) {
+        return packagePath;
+      }
+    } catch (error) {
+      // Fallback: use the current package directory
+      console.log('⚠️  Using local package directory as fallback');
+    }
+    
+    return this.packageDir;
+  }
+
+  async verifyInstallation() {
+    console.log('🔍 Verifying installation...');
+    
+    // Check if config file exists and is valid
+    if (!existsSync(this.claudeConfigPath)) {
+      throw new Error('Configuration file was not created');
+    }
+
+    try {
+      const configContent = readFileSync(this.claudeConfigPath, 'utf8');
+      const config = JSON.parse(configContent);
+      
+      if (!config.mcpServers?.[this.serverName]) {
+        throw new Error('Puppeteer MCP Claude not found in configuration');
+      }
+      
+      const serverConfig = config.mcpServers[this.serverName];
+      
+      // Verify configuration structure
+      if (!serverConfig.command || !serverConfig.args) {
+        throw new Error('Incomplete MCP server configuration');
+      }
+      
+      // Verify server configuration (skip path check for npx commands)
+      let serverInfo = '';
+      if (serverConfig.command === 'npx' && serverConfig.args[0] === 'puppeteer-mcp-claude') {
+        // For npx commands, we just verify the structure is correct
+        console.log('✅ NPX configuration verified');
+        serverInfo = `${serverConfig.command} ${serverConfig.args.join(' ')}`;
+      } else {
+        // For direct paths, check if the file exists
+        const serverPath = serverConfig.args[0];
+        if (!existsSync(serverPath)) {
+          throw new Error(`Server executable not found at: ${serverPath}`);
+        }
+        console.log(`✅ Server executable found: ${serverPath}`);
+        serverInfo = serverPath;
+      }
+      
+      console.log('✅ Installation verified');
+      console.log(`   Server: ${serverInfo}`);
+      
+    } catch (error) {
+      throw new Error(`Installation verification failed: ${error.message}`);
+    }
+  }
+
+  async serve() {
+    // Start the MCP server
+    const serverPath = join(this.packageDir, 'dist', 'index.js');
+    if (!existsSync(serverPath)) {
+      console.error('❌ Server executable not found. Please ensure the package is built properly.');
+      process.exit(1);
+    }
+    
+    // Execute the server
+    const server = spawn('node', [serverPath], {
+      stdio: 'inherit',
+      cwd: this.packageDir
+    });
+    
+    server.on('error', (error) => {
+      console.error('❌ Failed to start server:', error);
+      process.exit(1);
+    });
+    
+    server.on('exit', (code) => {
+      process.exit(code);
+    });
+  }
+
+  showHelp() {
+    console.log('🤖 Puppeteer MCP Claude - Browser Automation for Claude Code\n');
+    console.log('Usage:');
+    console.log('  npx puppeteer-mcp-claude install    # Install MCP server for Claude Code');
+    console.log('  npx puppeteer-mcp-claude uninstall  # Remove MCP server from Claude Code');
+    console.log('  npx puppeteer-mcp-claude status     # Check installation status');
+    console.log('  npx puppeteer-mcp-claude serve      # Start the MCP server (used internally)');
+    console.log('  npx puppeteer-mcp-claude help       # Show this help message');
+    console.log('\nAvailable Browser Tools:');
+    console.log('  • puppeteer_launch         - Launch browser instance');
+    console.log('  • puppeteer_new_page       - Create new browser tab');
+    console.log('  • puppeteer_navigate       - Navigate to URL');
+    console.log('  • puppeteer_click          - Click elements');
+    console.log('  • puppeteer_type           - Type text into inputs');
+    console.log('  • puppeteer_get_text       - Extract text from elements');
+    console.log('  • puppeteer_screenshot     - Capture screenshots');
+    console.log('  • puppeteer_evaluate       - Execute JavaScript');
+    console.log('  • puppeteer_wait_for_selector - Wait for elements');
+    console.log('  • puppeteer_close_page     - Close browser tab');
+    console.log('  • puppeteer_close_browser  - Close entire browser');
+    console.log('\nDocumentation: https://github.com/jaenster/puppeteer-mcp-claude');
+    console.log('Issues: https://github.com/jaenster/puppeteer-mcp-claude/issues');
+  }
+}
+
+// CLI interface
+async function main() {
+  const command = process.argv[2];
+  const installer = new PuppeteerMCPInstaller();
+
+  switch (command) {
+    case 'install':
+      await installer.install();
+      break;
+    case 'uninstall':
+      await installer.uninstall();
+      break;
+    case 'status':
+      await installer.status();
+      break;
+    case 'serve':
+      await installer.serve();
+      break;
+    case 'help':
+    case '--help':
+    case '-h':
+      installer.showHelp();
+      break;
+    default:
+      if (!command) {
+        installer.showHelp();
+      } else {
+        console.error(`Unknown command: ${command}`);
+        console.log('Run "npx puppeteer-mcp-claude help" for usage information.');
+        process.exit(1);
+      }
+      break;
+  }
+}
+
+main().catch(error => {
+  console.error('❌ Error:', error.message);
+  process.exit(1);
+});

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,411 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const puppeteer_1 = __importDefault(require("puppeteer"));
+class PuppeteerMCPServer {
+    server;
+    browser = null;
+    pages = new Map();
+    constructor() {
+        this.server = new index_js_1.Server({
+            name: 'mcp-puppeteer',
+            version: '1.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+            },
+        });
+        this.setupToolHandlers();
+        this.setupErrorHandling();
+    }
+    setupErrorHandling() {
+        this.server.onerror = (error) => console.error('[MCP Error]', error);
+        process.on('SIGINT', async () => {
+            await this.cleanup();
+            process.exit(0);
+        });
+    }
+    async cleanup() {
+        if (this.browser) {
+            await this.browser.close();
+        }
+    }
+    setupToolHandlers() {
+        this.server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+            return {
+                tools: [
+                    {
+                        name: 'puppeteer_launch',
+                        description: 'Launch a new Puppeteer browser instance',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                headless: { type: 'boolean', default: true },
+                                args: { type: 'array', items: { type: 'string' } },
+                            },
+                        },
+                    },
+                    {
+                        name: 'puppeteer_new_page',
+                        description: 'Create a new page in the browser',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                pageId: { type: 'string', description: 'Unique identifier for the page' },
+                            },
+                            required: ['pageId'],
+                        },
+                    },
+                    {
+                        name: 'puppeteer_navigate',
+                        description: 'Navigate to a URL',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                pageId: { type: 'string' },
+                                url: { type: 'string' },
+                                waitUntil: { type: 'string', enum: ['load', 'domcontentloaded', 'networkidle0', 'networkidle2'] },
+                            },
+                            required: ['pageId', 'url'],
+                        },
+                    },
+                    {
+                        name: 'puppeteer_click',
+                        description: 'Click on an element',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                pageId: { type: 'string' },
+                                selector: { type: 'string' },
+                            },
+                            required: ['pageId', 'selector'],
+                        },
+                    },
+                    {
+                        name: 'puppeteer_type',
+                        description: 'Type text into an element',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                pageId: { type: 'string' },
+                                selector: { type: 'string' },
+                                text: { type: 'string' },
+                            },
+                            required: ['pageId', 'selector', 'text'],
+                        },
+                    },
+                    {
+                        name: 'puppeteer_get_text',
+                        description: 'Get text content from an element',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                pageId: { type: 'string' },
+                                selector: { type: 'string' },
+                            },
+                            required: ['pageId', 'selector'],
+                        },
+                    },
+                    {
+                        name: 'puppeteer_screenshot',
+                        description: 'Take a screenshot of the page',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                pageId: { type: 'string' },
+                                path: { type: 'string' },
+                                fullPage: { type: 'boolean', default: false },
+                            },
+                            required: ['pageId'],
+                        },
+                    },
+                    {
+                        name: 'puppeteer_evaluate',
+                        description: 'Execute JavaScript in the page context',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                pageId: { type: 'string' },
+                                script: { type: 'string' },
+                            },
+                            required: ['pageId', 'script'],
+                        },
+                    },
+                    {
+                        name: 'puppeteer_wait_for_selector',
+                        description: 'Wait for a selector to appear',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                pageId: { type: 'string' },
+                                selector: { type: 'string' },
+                                timeout: { type: 'number', default: 30000 },
+                            },
+                            required: ['pageId', 'selector'],
+                        },
+                    },
+                    {
+                        name: 'puppeteer_close_page',
+                        description: 'Close a specific page',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                pageId: { type: 'string' },
+                            },
+                            required: ['pageId'],
+                        },
+                    },
+                    {
+                        name: 'puppeteer_close_browser',
+                        description: 'Close the browser and all pages',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {},
+                        },
+                    },
+                ],
+            };
+        });
+        this.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                switch (name) {
+                    case 'puppeteer_launch':
+                        return await this.handleLaunch(args);
+                    case 'puppeteer_new_page':
+                        return await this.handleNewPage(args);
+                    case 'puppeteer_navigate':
+                        return await this.handleNavigate(args);
+                    case 'puppeteer_click':
+                        return await this.handleClick(args);
+                    case 'puppeteer_type':
+                        return await this.handleType(args);
+                    case 'puppeteer_get_text':
+                        return await this.handleGetText(args);
+                    case 'puppeteer_screenshot':
+                        return await this.handleScreenshot(args);
+                    case 'puppeteer_evaluate':
+                        return await this.handleEvaluate(args);
+                    case 'puppeteer_wait_for_selector':
+                        return await this.handleWaitForSelector(args);
+                    case 'puppeteer_close_page':
+                        return await this.handleClosePage(args);
+                    case 'puppeteer_close_browser':
+                        return await this.handleCloseBrowser(args);
+                    default:
+                        throw new Error(`Unknown tool: ${name}`);
+                }
+            }
+            catch (error) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                        },
+                    ],
+                };
+            }
+        });
+    }
+    async handleLaunch(args) {
+        const { headless = true, args: browserArgs = [] } = args;
+        if (this.browser) {
+            await this.browser.close();
+        }
+        this.browser = await puppeteer_1.default.launch({
+            headless,
+            args: [...browserArgs, '--no-sandbox', '--disable-setuid-sandbox'],
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Browser launched successfully',
+                },
+            ],
+        };
+    }
+    async handleNewPage(args) {
+        const { pageId } = args;
+        if (!this.browser) {
+            throw new Error('Browser not launched. Call puppeteer_launch first.');
+        }
+        const page = await this.browser.newPage();
+        this.pages.set(pageId, page);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Page ${pageId} created successfully`,
+                },
+            ],
+        };
+    }
+    async handleNavigate(args) {
+        const { pageId, url, waitUntil = 'load' } = args;
+        const page = this.pages.get(pageId);
+        if (!page) {
+            throw new Error(`Page ${pageId} not found`);
+        }
+        await page.goto(url, { waitUntil });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Navigated to ${url}`,
+                },
+            ],
+        };
+    }
+    async handleClick(args) {
+        const { pageId, selector } = args;
+        const page = this.pages.get(pageId);
+        if (!page) {
+            throw new Error(`Page ${pageId} not found`);
+        }
+        await page.click(selector);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Clicked on ${selector}`,
+                },
+            ],
+        };
+    }
+    async handleType(args) {
+        const { pageId, selector, text } = args;
+        const page = this.pages.get(pageId);
+        if (!page) {
+            throw new Error(`Page ${pageId} not found`);
+        }
+        await page.type(selector, text);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Typed "${text}" into ${selector}`,
+                },
+            ],
+        };
+    }
+    async handleGetText(args) {
+        const { pageId, selector } = args;
+        const page = this.pages.get(pageId);
+        if (!page) {
+            throw new Error(`Page ${pageId} not found`);
+        }
+        const element = await page.$(selector);
+        if (!element) {
+            throw new Error(`Element ${selector} not found`);
+        }
+        const text = await page.evaluate((el) => el.textContent, element);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Text from ${selector}: ${text}`,
+                },
+            ],
+        };
+    }
+    async handleScreenshot(args) {
+        const { pageId, path, fullPage = false } = args;
+        const page = this.pages.get(pageId);
+        if (!page) {
+            throw new Error(`Page ${pageId} not found`);
+        }
+        const screenshot = await page.screenshot({
+            path,
+            fullPage,
+            type: 'png'
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: path ? `Screenshot saved to ${path}` : 'Screenshot taken',
+                },
+            ],
+        };
+    }
+    async handleEvaluate(args) {
+        const { pageId, script } = args;
+        const page = this.pages.get(pageId);
+        if (!page) {
+            throw new Error(`Page ${pageId} not found`);
+        }
+        const result = await page.evaluate(script);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Script result: ${JSON.stringify(result)}`,
+                },
+            ],
+        };
+    }
+    async handleWaitForSelector(args) {
+        const { pageId, selector, timeout = 30000 } = args;
+        const page = this.pages.get(pageId);
+        if (!page) {
+            throw new Error(`Page ${pageId} not found`);
+        }
+        await page.waitForSelector(selector, { timeout });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Selector ${selector} appeared`,
+                },
+            ],
+        };
+    }
+    async handleClosePage(args) {
+        const { pageId } = args;
+        const page = this.pages.get(pageId);
+        if (!page) {
+            throw new Error(`Page ${pageId} not found`);
+        }
+        await page.close();
+        this.pages.delete(pageId);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Page ${pageId} closed`,
+                },
+            ],
+        };
+    }
+    async handleCloseBrowser(args) {
+        if (this.browser) {
+            await this.browser.close();
+            this.browser = null;
+            this.pages.clear();
+        }
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: 'Browser closed',
+                },
+            ],
+        };
+    }
+    async run() {
+        const transport = new stdio_js_1.StdioServerTransport();
+        await this.server.connect(transport);
+        console.error('MCP Puppeteer server running on stdio');
+    }
+}
+const server = new PuppeteerMCPServer();
+server.run().catch(console.error);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "puppeteer-mcp-claude",
+  "version": "0.0.1",
+  "main": "dist/index.js",
+  "bin": {
+    "puppeteer-mcp-claude": "./bin/cli.js"
+  },
+  "files": [
+    "dist/",
+    "bin/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts",
+    "test": "ts-node tests/e2e.ts",
+    "test:integration": "ts-node tests/claude-integration.ts",
+    "test:claude": "ts-node tests/claude-simple-test.ts",
+    "test:real": "ts-node tests/real-claude-test.ts",
+    "test:console": "ts-node tests/console-claude-test.ts",
+    "setup-mcp": "ts-node scripts/setup-mcp.ts setup",
+    "remove-mcp": "ts-node scripts/setup-mcp.ts remove",
+    "status-mcp": "ts-node scripts/setup-mcp.ts status",
+    "prepublishOnly": "npm run build",
+    "prepack": "npm run build"
+  },
+  "keywords": ["mcp", "puppeteer", "claude", "browser-automation", "model-context-protocol"],
+  "author": "jaenster",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jaenster/puppeteer-mcp-claude.git"
+  },
+  "bugs": {
+    "url": "https://github.com/jaenster/puppeteer-mcp-claude/issues"
+  },
+  "homepage": "https://github.com/jaenster/puppeteer-mcp-claude#readme",
+  "license": "MIT",
+  "description": "A Model Context Protocol (MCP) server that provides Claude Code with comprehensive browser automation capabilities through Puppeteer",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.15.0",
+    "@types/node": "^24.0.10",
+    "puppeteer": "^24.12.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3"
+  }
+}