<!-- Use this file to provide workspace-specific custom instructions to Copilot. For more details, visit https://code.visualstudio.com/docs/copilot/copilot-customization#_use-a-githubcopilotinstructionsmd-file -->
# VS Code Simple Browser MCP Server
This is an MCP (Model Context Protocol) server project for interacting with VS Code's Simple Browser.
## Key Information
- **Purpose**: Enable LLMs to interact with websites through VS Code's Simple Browser and monitor console logs
- **Architecture**: TypeScript MCP server using the official MCP SDK
- **Main capabilities**:
- Open URLs in Simple Browser
- Navigate between pages
- Execute JavaScript in browser context
- Monitor and retrieve console logs
- Get browser state and current URL
- Refresh pages and close browser
## Important Implementation Notes
1. **VS Code Integration**: This server integrates with VS Code's Simple Browser through command execution and webview message passing
2. **Console Log Monitoring**: Implements real-time console log capture and storage
3. **State Management**: Maintains browser state including current URL, open status, and console history
4. **Error Handling**: Comprehensive error handling for all browser operations
## Development Guidelines
- Use the official MCP SDK patterns for tool definitions
- Follow TypeScript strict mode requirements
- Implement proper error handling for all VS Code API interactions
- Use Zod schemas for input validation
- Maintain consistent async/await patterns
## Resources
You can find more info and examples at https://modelcontextprotocol.io/llms-full.txt
## VS Code API Integration
When working with VS Code APIs, use the `vscode` module and follow the extension development patterns. Key areas:
- Simple Browser commands: `simpleBrowser.api.open`
- Webview message passing for JavaScript execution
- Console log capture through webview events
- Command palette integration for browser controls