chrome-devtools-mcp-singleton
CommunityEnsure one stable Chrome DevTools MCP server
Software Engineering#mcp#chrome-devtools#process-management#smoke-tests#singleton#headless-chrome#pid-file
Authorjoelklabo
Version1.0.0
Installs0
System Documentation
What problem does it solve?
Prevents multiple concurrent chrome-devtools-mcp processes from causing EMFILE, process-spawn, or client connection issues by enforcing a single running MCP server instance and providing safe start/stop/status workflows.
Core Features & Use Cases
- Enforces a single system-wide chrome-devtools-mcp instance with dedupe logic that kills extra processes.
- Manages PID and log state, exposes configurable environment variables for command, args, state directory, and keepalive behavior.
- Provides start, run (foreground), stop, status, and dedupe commands plus smoke tests and multiple MCP client helpers for automated checks and diagnostics.
- Use Cases: local development where multiple toolchains spawn MCP servers, CI smoke tests needing a stable MCP endpoint, and debugging headless Chrome via an isolated singleton server.
Quick Start
Use the bundled run_chrome_devtools_mcp.sh script to start the singleton MCP server, check its status, or stop it as needed.
Dependency Matrix
Required Modules
chrome-devtools-mcp@modelcontextprotocol/sdk
Components
scripts
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: chrome-devtools-mcp-singleton Download link: https://github.com/joelklabo/markdowntown-cli/archive/main.zip#chrome-devtools-mcp-singleton Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.