flowlens-mcp-server
by magentic
FlowLens is an open-source MCP server that gives your coding agent (Claude Code, Cursor, Copilot, Codex) full browser context for in-depth debugging and regression testing.
105stars
5forks
Python
Added 1/14/2026
AI Agentsai-agentsbug-reporterchrome-extensionclaudeclaudecode
Installation
# Add to your Claude Code skills
git clone https://github.com/magentic/flowlens-mcp-serverFlowLens MCP
flowlens-mcp-server gives your coding agent (Claude Code, Cursor, Copilot, Codex) full browser context for in-depth debugging and regression testing.
How it works
- Record your browser flow using the <a href="https://chromewebstore.google.com/detail/jecmhbndeedjenagcngpdmjgomhjgobf?utm_source=github-repo" target="_blank" rel="noopener noreferrer">FlowLens Chrome extension</a> (user actions, network, console, storage, DOM events/screen recording).
- Share it with your coding agent via the FlowLens MCP server, giving the agent full access to the recording.
- Your agent inspects and analyzes the flow for debugging and insights — without spending time/tokens on reproducing the issue.
Demo
<video src="https://github.com/user-attachments/assets/fd73f2e6-6a7d-4518-b0db-62b8c6e6c99a" autoplay loop muted playsinline></video>
Requirements
- <a href="https://chromewebstore.google.com/detail/jecmhbndeedjenagcngpdmjgomhjgobf?utm_source=github-repo" target="_blank" rel="noopener noreferrer">FlowLens browser extension</a> add to chrome and pin for ease of use
- pipx
Getting Started
To install:
pipx install flowlens-mcp-server
To upgrade to the latest version:
pipx upgrade flowlens-mcp-server
To check that the installation was successfully:
flowlens-mcp-server
Add FlowLens MCP server
Add the following config to your MCP client (ex: ) under :
<details> <summary>Claude Code</summary> Use the Claude Code CLI to add the FlowLens MCP server (<a href="https://docs.anthropic.com/en/docs/claude-code/mcp" target="_blank" rel="noopener noreferrer">guide</a>): </details> <details> <summary>Cursor</summary> </details> <details> <summary>Copilot / VS Code</summary> Follow the MCP install <a href="https://code.visualstudio.com/docs/copilot/chat/mcp-servers#_add-an-mcp-server" target="_blank" rel="noopener noreferrer">guide</a>, with the standard config from above. You can also install the FlowLens MCP server using the VS Code CLI: </details> <details> <summary>Codex</summary> Use the Codex CLI to add the FlowLens MCP server <a href="https://github.com/openai/codex/blob/mai...