-
- 
-
- |
-
-
- |
-
| MseeP.ai Security Assessment | -Special thanks to Warp, the AI terminal for developers | -
|
-
-
-
- |
-
-
- |
-
| MseeP.ai Security Assessment | -Special thanks to Warp, the AI terminal for developers | -
](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522playwright%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540executeautomation%252Fplaywright-mcp-server%2522%255D%257D)
-[
](https://insiders.vscode.dev/redirect?url=vscode-insiders%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522playwright%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540executeautomation%252Fplaywright-mcp-server%2522%255D%257D)
+// Use Playwright's automatic piercing
+await pierce_shadow_dom({
+ selector: "custom-element button.internal",
+ action: "click"
+});
+```
-Alternatively, you can install the Playwright MCP server using the VS Code CLI:
+### Mobile Testing
-```bash
-# For VS Code
-code --add-mcp '{"name":"playwright","command":"npx","args":["@executeautomation/playwright-mcp-server"]}'
+```javascript
+// Emulate iPhone
+await mobile_emulation({ device: "iPhone 13" });
+
+// Perform touch gestures
+await touch_gesture({
+ gesture: "swipe",
+ coordinates: {
+ startX: 100, startY: 300,
+ endX: 300, endY: 300
+ }
+});
+
+// Test orientation changes
+await mobile_interaction({
+ action: "setOrientation",
+ options: { orientation: "landscape" }
+});
```
-```bash
-# For VS Code Insiders
-code-insiders --add-mcp '{"name":"playwright","command":"npx","args":["@executeautomation/playwright-mcp-server"]}'
+### Advanced Dropdown Handling
+
+```javascript
+// Analyze dropdown structure
+await analyze_dropdown({ selector: "#country-select" });
+
+// Select by different methods
+await advanced_dropdown({
+ selector: "#country-select",
+ action: "selectByLabel",
+ options: { label: "United States" }
+});
+
+// Handle custom dropdowns
+await custom_dropdown({
+ triggerSelector: ".custom-dropdown-trigger",
+ optionSelector: ".dropdown-option",
+ optionText: "Option 2"
+});
```
-After installation, the ExecuteAutomation Playwright MCP server will be available for use with your GitHub Copilot agent in VS Code.
+### Network Control
+
+```javascript
+// Mock API responses
+await network_interception({
+ action: "mock",
+ pattern: "**/api/users",
+ response: {
+ status: 200,
+ body: JSON.stringify({ users: [] }),
+ contentType: "application/json"
+ }
+});
+
+// Monitor network requests
+await network_monitor({ action: "startMonitoring" });
+await network_monitor({
+ action: "waitForRequest",
+ options: { urlPattern: "/api/data" }
+});
+```
-## Configuration to use Playwright Server
-Here's the Claude Desktop configuration to use the Playwright server:
+### Accessibility Testing
-```json
-{
- "mcpServers": {
- "playwright": {
- "command": "npx",
- "args": ["-y", "@executeautomation/playwright-mcp-server"]
- }
+```javascript
+// Run accessibility scan
+await accessibility_test({
+ action: "scan",
+ options: {
+ tags: ["wcag2a", "wcag2aa"],
+ include: "main"
}
-}
+});
+
+// Test keyboard navigation
+await keyboard_navigation({ action: "tabSequence" });
+
+// Find elements by accessibility role
+await accessibility_tree({
+ action: "findByRole",
+ role: "button",
+ name: "Submit"
+});
```
-## Testing
+### Performance Monitoring
-This project uses Jest for testing. The tests are located in the `src/__tests__` directory.
+```javascript
+// Start performance tracing
+await performance_monitor({
+ action: "startTracing",
+ options: { screenshots: true }
+});
-### Running Tests
+// Get Core Web Vitals
+await performance_monitor({ action: "getCoreWebVitals" });
-You can run the tests using one of the following commands:
+// Monitor memory usage
+await resource_monitor({ action: "memoryUsage" });
-```bash
-# Run tests using the custom script (with coverage)
-node run-tests.cjs
+// Stop tracing
+await performance_monitor({ action: "stopTracing" });
+```
+
+### Debugging
+
+```javascript
+// Start step-by-step debugging
+await step_debugger({ action: "pause" });
+
+// Inspect an element
+await debug_tracing({
+ action: "debugElement",
+ options: { selector: "#problematic-element" }
+});
+
+// Capture console logs
+await debug_tracing({ action: "captureConsole" });
+await debug_tracing({ action: "getConsoleLogs" });
+```
+
+## 🏗️ Architecture
+
+The server is built with a modular architecture:
-# Run tests using npm scripts
-npm test # Run tests without coverage
-npm run test:coverage # Run tests with coverage
-npm run test:custom # Run tests with custom script (same as node run-tests.cjs)
```
+src/
+├── tools/
+│ ├── browser/
+│ │ ├── navigation.ts # Navigation tools
+│ │ ├── interaction.ts # Basic interactions
+│ │ ├── shadowdom.ts # Shadow DOM tools
+│ │ ├── dropdown.ts # Dropdown tools
+│ │ ├── mobile.ts # Mobile & touch tools
+│ │ ├── network.ts # Network tools
+│ │ ├── storage.ts # Storage management
+│ │ ├── accessibility.ts # Accessibility tools
+│ │ ├── performance.ts # Performance monitoring
+│ │ ├── debugging.ts # Debugging tools
+│ │ └── output.ts # Output & extraction
+│ ├── codegen/ # Code generation
+│ └── common/ # Shared utilities
+├── requestHandler.ts # Main request handler
+└── tools.ts # Tool definitions
+```
+
+## 🔄 Merge Strategy
+
+This extended version is designed to be easily mergeable with updates from the original repository:
+
+1. **Modular Extensions**: New features are in separate files
+2. **Non-Breaking Changes**: Existing APIs remain unchanged
+3. **Additive Approach**: Only adds new tools, doesn't modify existing ones
+4. **Clear Separation**: Extended tools are clearly marked and documented
+
+To merge updates from the original repository:
+
+```bash
+# Add original repository as upstream
+git remote add upstream https://github.com/original/mcp-playwright.git
-The test coverage report will be generated in the `coverage` directory.
+# Fetch latest changes
+git fetch upstream
-### Running evals
+# Merge changes (resolve conflicts in favor of extensions)
+git merge upstream/main
+```
-The evals package loads an mcp client that then runs the index.ts file, so there is no need to rebuild between tests. You can load environment variables by prefixing the npx command. Full documentation can be found [here](https://www.mcpevals.io/docs).
+## 🧪 Testing
```bash
-OPENAI_API_KEY=your-key npx mcp-eval src/evals/evals.ts src/tools/codegen/index.ts
+# Run all tests
+npm test
+
+# Run specific test suites
+npm run test:browser
+npm run test:mobile
+npm run test:accessibility
+npm run test:performance
+
+# Run with coverage
+npm run test:coverage
```
-## Contributing
+## 📚 API Reference
+
+### Tool Categories
+
+1. **Navigation Tools**: `goto`, `go_back`, `go_forward`, `reload`
+2. **Interaction Tools**: `click`, `fill`, `select`, `hover`, `drag`, `upload_file`
+3. **Shadow DOM Tools**: `analyze_shadow_dom`, `interact_shadow_dom`, `pierce_shadow_dom`
+4. **Dropdown Tools**: `advanced_dropdown`, `custom_dropdown`, `analyze_dropdown`
+5. **Mobile Tools**: `mobile_emulation`, `touch_gesture`, `mobile_interaction`
+6. **Network Tools**: `network_interception`, `network_monitor`, `websocket_tool`
+7. **Storage Tools**: `cookie_management`, `local_storage`, `session_storage`, `storage_state`
+8. **Accessibility Tools**: `accessibility_test`, `accessibility_tree`, `keyboard_navigation`
+9. **Performance Tools**: `performance_monitor`, `lighthouse_audit`, `resource_monitor`
+10. **Debugging Tools**: `debug_tracing`, `step_debugger`, `devtools_integration`
+11. **Output Tools**: `screenshot`, `get_page_content`, `get_text_content`, etc.
+
+### Error Handling
+
+All tools include comprehensive error handling with detailed error messages and suggestions for resolution.
+
+### Timeouts
+
+Default timeouts can be configured globally or per-tool:
+- Element interactions: 30 seconds
+- Network requests: 30 seconds
+- Page loads: 30 seconds
+
+## 🤝 Contributing
+
+1. Fork the repository
+2. Create a feature branch
+3. Add tests for new functionality
+4. Ensure all tests pass
+5. Submit a pull request
+
+## 📄 License
+
+MIT License - see LICENSE file for details.
+
+## 🔗 Related Projects
+
+- [Playwright](https://playwright.dev/) - The underlying browser automation library
+- [MCP SDK](https://github.com/modelcontextprotocol/sdk) - Model Context Protocol SDK
+- [axe-core](https://github.com/dequelabs/axe-core) - Accessibility testing engine
-When adding new tools, please be mindful of the tool name length. Some clients, like Cursor, have a 60-character limit for the combined server and tool name (`server_name:tool_name`).
+## 📞 Support
-Our server name is `playwright-mcp`. Please ensure your tool names are short enough to not exceed this limit.
+For issues and questions:
+1. Check the [documentation](./docs/)
+2. Search existing [issues](../../issues)
+3. Create a new issue with detailed reproduction steps
-## Star History
+---
-[](https://star-history.com/#executeautomation/mcp-playwright&Date)
+**Note**: This is an extended version of the original mcp-playwright server with comprehensive additional features for modern web testing needs.
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
new file mode 100644
index 0000000..cd3eb8d
--- /dev/null
+++ b/docs/CHANGELOG.md
@@ -0,0 +1,265 @@
+
+# Changelog
+
+All notable changes to the mcp-playwright_Mod project will be documented in this file.
+
+## [2.0.0] - 2025-07-05
+
+### 🚀 Major Features Added
+
+#### Shadow DOM Support
+- **NEW**: `analyze_shadow_dom` - Comprehensive Shadow DOM analysis with CSS and XPath selectors
+- **NEW**: `interact_shadow_dom` - Direct interaction with Shadow DOM elements via JavaScript
+- **NEW**: `pierce_shadow_dom` - Leverage Playwright's built-in Shadow DOM piercing
+- **ENHANCED**: Extended JavaScript function for Shadow DOM analysis with innerText and XPath support
+
+#### Advanced Dropdown Management
+- **NEW**: `advanced_dropdown` - Enhanced dropdown interactions with multiple selection methods
+- **NEW**: `custom_dropdown` - Support for non-select element dropdowns
+- **NEW**: `analyze_dropdown` - Comprehensive dropdown structure analysis
+- **ENHANCED**: Multi-select support and option management
+
+#### Mobile & Touch Testing
+- **NEW**: `mobile_emulation` - Device emulation for popular mobile devices
+- **NEW**: `touch_gesture` - Complete touch gesture support (tap, swipe, pinch, long press)
+- **NEW**: `mobile_interaction` - Mobile-specific interactions (orientation, geolocation, network)
+- **ENHANCED**: Multi-touch gesture simulation with customizable parameters
+
+#### Network Control & Monitoring
+- **NEW**: `network_interception` - Advanced request interception (mock, block, modify, delay)
+- **NEW**: `network_monitor` - Comprehensive network traffic monitoring
+- **NEW**: `websocket_tool` - WebSocket connection monitoring and mocking
+- **ENHANCED**: HAR file support and request/response modification
+
+#### Storage Management
+- **NEW**: `cookie_management` - Full CRUD operations for cookies with import/export
+- **NEW**: `local_storage` - Complete localStorage management
+- **NEW**: `session_storage` - Full sessionStorage control
+- **NEW**: `storage_state` - Save and restore complete browser state
+- **ENHANCED**: Cross-context storage state management
+
+#### Accessibility Testing
+- **NEW**: `accessibility_test` - axe-core integration for WCAG compliance testing
+- **NEW**: `accessibility_tree` - Accessibility tree analysis and navigation
+- **NEW**: `keyboard_navigation` - Tab sequence and focus management testing
+- **ENHANCED**: ARIA role-based element finding and accessibility reporting
+
+#### Performance Monitoring
+- **NEW**: `performance_monitor` - Core Web Vitals and performance metrics collection
+- **NEW**: `lighthouse_audit` - Basic Lighthouse-style audits
+- **NEW**: `resource_monitor` - Memory usage and resource monitoring
+- **ENHANCED**: Detailed performance tracing with screenshots
+
+#### Advanced Debugging
+- **NEW**: `debug_tracing` - Comprehensive debugging with tracing and console capture
+- **NEW**: `step_debugger` - Step-by-step debugging with visual feedback
+- **NEW**: `devtools_integration` - Chrome DevTools Protocol integration
+- **ENHANCED**: Element inspection and error monitoring
+
+### 🔧 Enhanced Existing Features
+
+#### Navigation Tools
+- **ENHANCED**: `goto` - Added waitUntil options and protocol validation
+- **ENHANCED**: `reload` - Added cache control options
+- **IMPROVED**: Error handling and timeout management
+
+#### Interaction Tools
+- **ENHANCED**: `click` - Added timeout configuration
+- **ENHANCED**: `fill` - Improved form field handling
+- **ENHANCED**: `select` - Better dropdown option selection
+- **IMPROVED**: Element waiting and visibility checks
+
+#### Output Tools
+- **ENHANCED**: `screenshot` - Added element-specific screenshots
+- **ENHANCED**: `get_page_content` - Added selector-based content extraction
+- **ENHANCED**: `wait_for_element` - Added state-based waiting
+- **IMPROVED**: Content extraction and formatting
+
+### 🏗️ Architecture Improvements
+
+#### Modular Structure
+- **NEW**: Organized tools into logical modules (shadowdom, mobile, network, etc.)
+- **NEW**: Separate files for each feature category
+- **NEW**: Enhanced base classes for tool development
+- **IMPROVED**: Code organization and maintainability
+
+#### Tool Definitions
+- **ENHANCED**: Comprehensive tool descriptions with usage examples
+- **ENHANCED**: Detailed parameter documentation
+- **ENHANCED**: Input validation and error messages
+- **IMPROVED**: Consistent API design across all tools
+
+#### Error Handling
+- **NEW**: Standardized error response format
+- **NEW**: Detailed error messages with troubleshooting hints
+- **NEW**: Graceful degradation for unsupported features
+- **IMPROVED**: Error recovery and retry mechanisms
+
+### 📚 Documentation
+
+#### Comprehensive Documentation
+- **NEW**: Extended README with feature overview and examples
+- **NEW**: API reference for all tools
+- **NEW**: Usage examples for each feature category
+- **NEW**: Architecture documentation
+
+#### Developer Guide
+- **NEW**: Contributing guidelines
+- **NEW**: Testing instructions
+- **NEW**: Merge strategy documentation
+- **IMPROVED**: Code examples and best practices
+
+### 🧪 Testing & Quality
+
+#### Test Coverage
+- **NEW**: Test suites for all new features
+- **NEW**: Integration tests for complex workflows
+- **NEW**: Performance benchmarks
+- **IMPROVED**: Test organization and reliability
+
+#### Code Quality
+- **NEW**: TypeScript strict mode compliance
+- **NEW**: ESLint configuration with extended rules
+- **NEW**: Prettier code formatting
+- **IMPROVED**: Code documentation and comments
+
+### 🔄 Compatibility & Migration
+
+#### Backward Compatibility
+- **MAINTAINED**: All existing APIs remain unchanged
+- **MAINTAINED**: Existing tool names and parameters
+- **MAINTAINED**: Response formats for existing tools
+- **ENSURED**: No breaking changes for current users
+
+#### Migration Support
+- **NEW**: Migration guide for new features
+- **NEW**: Feature detection for optional capabilities
+- **NEW**: Graceful fallbacks for unsupported browsers
+- **PROVIDED**: Clear upgrade path documentation
+
+### 🚀 Performance Improvements
+
+#### Execution Speed
+- **IMPROVED**: Faster tool initialization
+- **IMPROVED**: Optimized element selection
+- **IMPROVED**: Reduced memory usage
+- **ENHANCED**: Better resource cleanup
+
+#### Browser Management
+- **IMPROVED**: More efficient browser context management
+- **IMPROVED**: Better page lifecycle handling
+- **IMPROVED**: Optimized screenshot and content extraction
+- **ENHANCED**: Smarter waiting strategies
+
+### 🔧 Configuration
+
+#### Environment Variables
+- **NEW**: `BROWSER` - Browser selection (chromium, firefox, webkit)
+- **NEW**: `VIEWPORT_WIDTH` - Default viewport width
+- **NEW**: `VIEWPORT_HEIGHT` - Default viewport height
+- **MAINTAINED**: `HEADLESS` - Headless mode control
+
+#### Tool Configuration
+- **NEW**: Per-tool timeout configuration
+- **NEW**: Global default settings
+- **NEW**: Feature flags for experimental features
+- **ENHANCED**: Flexible configuration options
+
+### 🐛 Bug Fixes
+
+#### Element Interaction
+- **FIXED**: Race conditions in element waiting
+- **FIXED**: Iframe interaction edge cases
+- **FIXED**: File upload path resolution
+- **IMPROVED**: Element visibility detection
+
+#### Browser Management
+- **FIXED**: Memory leaks in long-running sessions
+- **FIXED**: Context isolation issues
+- **FIXED**: Page navigation edge cases
+- **IMPROVED**: Error recovery mechanisms
+
+### 📦 Dependencies
+
+#### Updated Dependencies
+- **UPDATED**: Playwright to latest stable version
+- **UPDATED**: MCP SDK to latest version
+- **ADDED**: axe-core for accessibility testing
+- **MAINTAINED**: Minimal dependency footprint
+
+#### Development Dependencies
+- **ADDED**: Enhanced testing frameworks
+- **ADDED**: Code quality tools
+- **ADDED**: Documentation generators
+- **UPDATED**: Build tools and TypeScript
+
+---
+
+## [1.0.0] - Previous Version
+
+### Initial Features
+- Basic browser automation
+- Element interaction
+- Screenshot capabilities
+- Code generation
+- MCP server implementation
+
+---
+
+## Migration Guide
+
+### From 1.x to 2.0
+
+#### New Features Available
+All new features are additive and don't require changes to existing code. You can start using new tools immediately:
+
+```javascript
+// New Shadow DOM capabilities
+await analyze_shadow_dom({ tagNames: ["custom-element"] });
+
+// New mobile testing
+await mobile_emulation({ device: "iPhone 13" });
+
+// New accessibility testing
+await accessibility_test({ action: "scan" });
+```
+
+#### Configuration Updates
+Add new environment variables if desired:
+
+```json
+{
+ "env": {
+ "HEADLESS": "false",
+ "BROWSER": "chromium",
+ "VIEWPORT_WIDTH": "1280",
+ "VIEWPORT_HEIGHT": "720"
+ }
+}
+```
+
+#### No Breaking Changes
+- All existing tool names work unchanged
+- All existing parameters remain the same
+- All existing response formats are maintained
+- Existing scripts continue to work without modification
+
+---
+
+## Roadmap
+
+### Upcoming Features (v2.1)
+- [ ] Visual regression testing
+- [ ] Advanced screenshot comparison
+- [ ] Browser extension testing
+- [ ] Enhanced mobile device support
+
+### Future Enhancements (v2.2+)
+- [ ] AI-powered element selection
+- [ ] Automated test generation
+- [ ] Cross-browser compatibility testing
+- [ ] Performance regression detection
+
+---
+
+For detailed information about any feature, see the main [README.md](../README.md) or the specific tool documentation.
diff --git a/package-lock.json b/package-lock.json
index 38f6051..322770d 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -15,15 +15,18 @@
"@playwright/browser-webkit": "1.53.1",
"@playwright/test": "^1.53.1",
"mcp-evals": "^1.0.18",
- "playwright": "1.53.1",
+ "playwright": "^1.53.1",
"uuid": "11.1.0"
},
"bin": {
"playwright-mcp-server": "dist/index.js"
},
"devDependencies": {
+ "@axe-core/playwright": "^4.10.2",
"@types/jest": "^29.5.14",
"@types/node": "^20.10.5",
+ "@types/uuid": "^9.0.0",
+ "axe-core": "^4.10.2",
"jest": "^29.7.0",
"jest-playwright-preset": "4.0.0",
"shx": "^0.3.4",
@@ -198,6 +201,19 @@
"integrity": "sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA==",
"license": "MIT"
},
+ "node_modules/@axe-core/playwright": {
+ "version": "4.10.2",
+ "resolved": "https://registry.npmjs.org/@axe-core/playwright/-/playwright-4.10.2.tgz",
+ "integrity": "sha512-6/b5BJjG6hDaRNtgzLIfKr5DfwyiLHO4+ByTLB0cJgWSM8Ll7KqtdblIS6bEkwSF642/Ex91vNqIl3GLXGlceg==",
+ "dev": true,
+ "license": "MPL-2.0",
+ "dependencies": {
+ "axe-core": "~4.10.3"
+ },
+ "peerDependencies": {
+ "playwright-core": ">= 1.0.0"
+ }
+ },
"node_modules/@babel/code-frame": {
"version": "7.27.1",
"resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.27.1.tgz",
@@ -1738,6 +1754,13 @@
"dev": true,
"license": "MIT"
},
+ "node_modules/@types/uuid": {
+ "version": "9.0.8",
+ "resolved": "https://registry.npmjs.org/@types/uuid/-/uuid-9.0.8.tgz",
+ "integrity": "sha512-jg+97EGIcY9AGHJJRaaPVgetKDsrTgbRjQ5Msgjh/DQKEFl0DtyRr/VCOyD1T2R1MNeWPK/u7JoGhlDZnKBAfA==",
+ "dev": true,
+ "license": "MIT"
+ },
"node_modules/@types/wait-on": {
"version": "5.3.4",
"resolved": "https://registry.npmjs.org/@types/wait-on/-/wait-on-5.3.4.tgz",
@@ -1940,6 +1963,16 @@
"integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==",
"license": "MIT"
},
+ "node_modules/axe-core": {
+ "version": "4.10.3",
+ "resolved": "https://registry.npmjs.org/axe-core/-/axe-core-4.10.3.tgz",
+ "integrity": "sha512-Xm7bpRXnDSX2YE2YFfBk2FnF0ep6tmG7xPh8iHee8MIcrgq762Nkce856dYtJYLkuIoYZvGfTs/PbZhideTcEg==",
+ "dev": true,
+ "license": "MPL-2.0",
+ "engines": {
+ "node": ">=4"
+ }
+ },
"node_modules/axios": {
"version": "1.9.0",
"resolved": "https://registry.npmjs.org/axios/-/axios-1.9.0.tgz",
@@ -2101,9 +2134,9 @@
}
},
"node_modules/brace-expansion": {
- "version": "1.1.11",
- "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.11.tgz",
- "integrity": "sha512-iCuPHDFgrHX7H2vEI/5xpz07zSHB00TpugqhmYtVmMO6518mCuRMoOYFldEBl0g187ufozdaHgWKcYFb61qGiA==",
+ "version": "1.1.12",
+ "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz",
+ "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==",
"dev": true,
"license": "MIT",
"dependencies": {
@@ -3135,9 +3168,9 @@
}
},
"node_modules/filelist/node_modules/brace-expansion": {
- "version": "2.0.1",
- "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.1.tgz",
- "integrity": "sha512-XnAIvQ8eM+kC6aULx6wuQiwVsnzsi9d3WxzV3FpWTGA19F621kwdbsAcFKXgKUHZWsy+mY6iL1sHTxWEFCytDA==",
+ "version": "2.0.2",
+ "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.2.tgz",
+ "integrity": "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ==",
"dev": true,
"license": "MIT",
"dependencies": {
@@ -5749,6 +5782,7 @@
"version": "1.53.1",
"resolved": "https://registry.npmjs.org/playwright/-/playwright-1.53.1.tgz",
"integrity": "sha512-LJ13YLr/ocweuwxyGf1XNFWIU4M2zUSo149Qbp+A4cpwDjsxRPj7k6H25LBrEHiEwxvRbD8HdwvQmRMSvquhYw==",
+ "license": "Apache-2.0",
"dependencies": {
"playwright-core": "1.53.1"
},
diff --git a/package.json b/package.json
index 625859b..e08ecfe 100644
--- a/package.json
+++ b/package.json
@@ -33,7 +33,7 @@
"@playwright/browser-webkit": "1.53.1",
"@playwright/test": "^1.53.1",
"mcp-evals": "^1.0.18",
- "playwright": "1.53.1",
+ "playwright": "^1.53.1",
"uuid": "11.1.0"
},
"keywords": [
@@ -43,8 +43,11 @@
"Claude MCP"
],
"devDependencies": {
+ "@axe-core/playwright": "^4.10.2",
"@types/jest": "^29.5.14",
"@types/node": "^20.10.5",
+ "@types/uuid": "^9.0.0",
+ "axe-core": "^4.10.2",
"jest": "^29.7.0",
"jest-playwright-preset": "4.0.0",
"shx": "^0.3.4",
diff --git a/src/index.ts b/src/index.ts
index cc0cc89..84b00ff 100644
--- a/src/index.ts
+++ b/src/index.ts
@@ -46,4 +46,4 @@ async function runServer() {
runServer().catch((error) => {
console.error("Fatal error in main():", error);
process.exit(1);
-});
\ No newline at end of file
+});
diff --git a/src/requestHandler.ts b/src/requestHandler.ts
index a5de9fd..8d4561b 100644
--- a/src/requestHandler.ts
+++ b/src/requestHandler.ts
@@ -1,69 +1,41 @@
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import {
- ListResourcesRequestSchema,
- ReadResourceRequestSchema,
- ListToolsRequestSchema,
- CallToolRequestSchema,
- Tool
-} from "@modelcontextprotocol/sdk/types.js";
-import { handleToolCall, getConsoleLogs, getScreenshots } from "./toolHandler.js";
-
-export function setupRequestHandlers(server: Server, tools: Tool[]) {
- // List resources handler
- server.setRequestHandler(ListResourcesRequestSchema, async () => ({
- resources: [
- {
- uri: "console://logs",
- mimeType: "text/plain",
- name: "Browser console logs",
- },
- ...Array.from(getScreenshots().keys()).map(name => ({
- uri: `screenshot://${name}`,
- mimeType: "image/png",
- name: `Screenshot: ${name}`,
- })),
- ],
- }));
-
- // Read resource handler
- server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
- const uri = request.params.uri.toString();
- if (uri === "console://logs") {
- const logs = getConsoleLogs().join("\n");
- return {
- contents: [{
- uri,
- mimeType: "text/plain",
- text: logs,
- }],
- };
- }
+import { CallToolRequest, CallToolResult, Tool } from "@modelcontextprotocol/sdk/types.js";
+import { ListToolsRequestSchema, CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+import { createToolDefinitions } from "./tools.js";
+import { ToolContext, createErrorResponse } from "./tools/common/types.js";
+import { handleToolCall as toolHandlerCall } from "./toolHandler.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
- if (uri.startsWith("screenshot://")) {
- const name = uri.split("://")[1];
- const screenshot = getScreenshots().get(name);
- if (screenshot) {
- return {
- contents: [{
- uri,
- mimeType: "image/png",
- blob: screenshot,
- }],
- };
- }
- }
+export async function handleToolCall(request: CallToolRequest): Promise