Setup guides and reference manual
Welcome to the MiraiLens developer documentation. MiraiLens is a local browser control layer mapping AI workflows (via the Model Context Protocol) to your real Chrome browser. Follow this guide to set up the MCP server and browser connector on your local machine.
Before running MiraiLens, ensure your local environment meets the following specifications:
8080 must be available for local WebSocket loopback requests.Start the local MiraiLens MCP server daemon using standard Node toolchain commands. In your terminal, run:
* This initiates the local WebSocket server listening on port 8080.
Add the extension directly from the Chrome Web Store to establish the browser control interface:
* Developers building from source can load the unpacked extension in Chrome by enabling Developer Mode at chrome://extensions and selecting the unpacked extension directory.
Launch Google Chrome and click the MiraiLens Connector icon in your toolbar. Enter the local WebSocket address (default is ws://localhost:8080) and click Connect. The status indicator will glow green when connected.
Configure your preferred Model Context Protocol client (like Claude Desktop) to invoke the local server registry:
{
"mcpServers": {
"mirailens": {
"command": "npx",
"args": ["-y", "mirailens@latest"]
}
}
}Ask your AI agent to perform browser actions. The agent will formulate intent and request access. The local MCP server hands off instructions to the Chrome extension, which displays state changes in the browser dashboard interface.
Execution remains visible and interruptible. The human maintains final authority: