Added first cut of MCP-Playwright codebase

Author: executeautomation

.gitattributes

@@ -0,0 +1 @@
+package-lock.json linguist-generated=true

.npmrc

@@ -0,0 +1,2 @@
+registry="https://registry.npmjs.org/"
+@modelcontextprotocol:registry="https://registry.npmjs.org/"

README.md

@@ -1,2 +1,92 @@
-# mcp-playwright
-Repository contains Model Context Protocol support of Playwright for Claude
+# Playwright
+
+A Model Context Protocol server that provides browser automation capabilities using Playwright. This server enables LLMs to interact with web pages, take screenshots, and execute JavaScript in a real browser environment.
+
+
+## Here is how you need to build the code in your local machine
+
+**Clone the repository**
+```bash
+git clone https://github.com/executeautomation/mcp-playwright.git
+```
+
+**Build the code**
+```bash
+npm run build
+npm link
+```
+
+## Configuration to use Playwright Server
+Here's the Claude Desktop configuration to use the Playwright server:
+
+```json
+{
+  "mcpServers": {
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-playwright"]
+    }
+  }
+}
+```
+
+
+## Components
+
+### Tools
+
+- **playwright_navigate**
+  - Navigate to any URL in the browser
+  - Input: `url` (string)
+
+- **playwright_screenshot**
+  - Capture screenshots of the entire page or specific elements
+  - Inputs:
+    - `name` (string, required): Name for the screenshot
+    - `selector` (string, optional): CSS selector for element to screenshot
+    - `width` (number, optional, default: 800): Screenshot width
+    - `height` (number, optional, default: 600): Screenshot height
+
+- **playwright_click**
+  - Click elements on the page
+  - Input: `selector` (string): CSS selector for element to click
+
+- **playwright_hover**
+  - Hover elements on the page
+  - Input: `selector` (string): CSS selector for element to hover
+
+- **playwright_fill**
+  - Fill out input fields
+  - Inputs:
+    - `selector` (string): CSS selector for input field
+    - `value` (string): Value to fill
+
+- **playwright_select**
+  - Select an element with SELECT tag
+  - Inputs:
+    - `selector` (string): CSS selector for element to select
+    - `value` (string): Value to select
+
+- **playwright_evaluate**
+  - Execute JavaScript in the browser console
+  - Input: `script` (string): JavaScript code to execute
+
+### Resources
+
+The server provides access to two types of resources:
+
+1. **Console Logs** (`console://logs`)
+   - Browser console output in text format
+   - Includes all console messages from the browser
+
+2. **Screenshots** (`screenshot://<name>`)
+   - PNG images of captured screenshots
+   - Accessible via the screenshot name specified during capture
+
+## Key Features
+
+- Browser automation
+- Console log monitoring
+- Screenshot capabilities
+- JavaScript execution
+- Basic web interaction (navigation, clicking, form filling)

package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@modelcontextprotocol/servers",
+  "private": true,
+  "version": "0.5.1",
+  "description": "Model Context Protocol servers for Playwright",
+  "license": "MIT",
+  "author": "ExecuteAutomation, Ltd (https://executeautomation.com)",
+  "homepage": "https://github.com/executeautomation/mcp-playwright",
+  "bugs": "https://github.com/executeautomation/mcp-playwright/issues",
+  "type": "module",
+  "workspaces": [
+    "src/*"
+  ],
+  "files": [],
+  "scripts": {
+    "build": "npm run build --workspaces",
+    "watch": "npm run watch --workspaces",
+    "publish-all": "npm publish --workspaces --access public",
+    "link-all": "npm link --workspaces"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/server-playwright": "*"
+  }
+}