gitwtfhub

wtf is mobius-mcp?

topman-14/mobius-mcp — explained in plain English

Analysis updated 2026-05-18

5TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TL;DR

mobius-mcp streams a web app's live browser console logs, errors, network requests, and navigation events directly into AI coding agents so they can debug without copy-pasted logs.

Mindmap

mindmap
  root((mobius-mcp))
    What it does
      Streams console logs
      Streams network requests
      Streams navigation events
      Real time AI debugging
    Tech stack
      TypeScript
      Node.js
      WebSocket
      Chrome extension
    Use cases
      Live error checking
      Network inspection
      Debug session timelines
    Audience
      Claude Code users
      Codex CLI users
      Gemini CLI users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Let an AI coding agent read live browser console errors instead of pasting them manually.

REASON 2

Debug network requests and responses in real time by asking the AI agent to check them.

REASON 3

Record a timeline of console, network, and navigation events during a debugging session.

What's in the stack?

TypeScriptNode.jsWebSocketChrome extensionMCP

How it stacks up

topman-14/mobius-mcpcprecioso/tubecasterfarique/cursor-chat-explorer
Stars555
LanguageTypeScriptTypeScriptTypeScript
Last pushed2025-03-29
MaintenanceStale
Setup difficultymoderatemoderateeasy
Complexity3/52/52/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires installing a Chrome extension and registering the MCP server with your AI coding agent.

Permissive MIT license, use freely including for commercial purposes.

Wtf does this do

mobius-mcp gives AI coding assistants like Claude Code, Codex CLI, or Gemini CLI live access to what is happening inside your web app in the browser, without you having to copy and paste console logs or errors into the chat window. It streams console messages, errors, network requests, and page navigation events straight from the browser into the AI agent's tools in real time. It works through a small Chrome browser extension that captures runtime events on a tab you choose, then sends them over a local WebSocket connection to a server running on your own machine. That server, called mobius-mcp, keeps a rolling history of recent events and exposes them to the AI agent using the Model Context Protocol, or MCP, a standard way for AI tools to connect to external data sources. Everything happens on localhost, with no cloud services and no telemetry sent anywhere. Capture is opt in per browser tab, so nothing streams until you click the extension's toolbar icon and enable the tab you want to debug. You can also set up rules so tabs matching a certain address, like a local development server, enable themselves automatically. Once connected, you can ask your AI agent things like checking the browser console for errors, and it can look directly at the live data instead of guessing. Beyond basic logging, the tool offers features such as recording an ordered timeline of events during a debug session, waiting for a specific condition like a console error or a network request instead of repeatedly checking, taking screenshots, and inspecting the page's structure through the Chrome DevTools Protocol when the extension is connected. Recent event history is also saved to a temporary folder on disk, so it survives if the local server restarts. The project is organized as a Node.js server, the browser extension itself, and a paused npm package meant for direct app integration without the extension. It is published on npm, so using it does not require cloning the repository.

Yoink these prompts

Prompt 1
Help me register mobius-mcp with Claude Code and connect it to my browser tab.
Prompt 2
Ask my AI agent to check the browser console for errors using mobius-mcp.
Prompt 3
Explain how to set up an auto-enable rule for mobius-mcp on my local dev server.
Prompt 4
Walk me through starting a debug session with mobius-mcp to capture a bug's timeline.

Frequently asked questions

wtf is mobius-mcp?

mobius-mcp streams a web app's live browser console logs, errors, network requests, and navigation events directly into AI coding agents so they can debug without copy-pasted logs.

What language is mobius-mcp written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, WebSocket.

What license does mobius-mcp use?

Permissive MIT license, use freely including for commercial purposes.

How hard is mobius-mcp to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is mobius-mcp for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.