DevServer MCP

What is DevServer MCP?

DevServer MCP is a Model Context Protocol server that manages development servers for LLM-assisted workflows. It provides programmatic control over multiple development servers through a unified interface with a simple TUI, plus experimental browser automation via Playwright.

How to use DevServer MCP?

Install with uv add --dev git+https://github.com/Uninen/devserver-mcp.git --tag v0.2.0. Create a devservers.yml configuration file in your project root defining servers, then start the TUI by running devservers. Optionally install Playwright for browser automation.

Key features of DevServer MCP

• Process management: start, stop, and monitor multiple development servers
• Rich TUI with interactive terminal interface and real-time log streaming
• Experimental Playwright integration for web testing and automation
• Full MCP protocol support for AI-assisted development workflows
• Server control via both TUI clicks and LLM tools
• Configurable through a YAML definition file

Use cases of DevServer MCP

• Managing local development servers (backend, frontend, worker) while an LLM agent interacts with them
• Allowing an AI assistant to start/stop servers and read logs during development
• Automating browser testing by combining Playwright snapshots with MCP tools
• Vibe coding or LLM-assisted projects where the AI needs to control the dev environment

FAQ from DevServer MCP

Is DevServer MCP production-ready?

No, this is ALPHA software and an exercise in vibe coding—most of the codebase is written with the help of LLM tools. Tests validate some functionality and the server is already useful, but your mileage may vary.

What are the dependencies and runtime requirements?

Python (with uv). For Playwright features, you must manually install Playwright and run playwright install for browser drivers.

How do I configure DevServer MCP for VSCode (Roo Cline)?

Add an entry to .vscode/mcp.json with the server URL http://localhost:3001/mcp/ and type http.

How do I configure DevServer MCP for Claude Code?

Install the server using the SSE transport: claude mcp add --transport sse devserver http://localhost:3001/sse/ (Claude Code does not yet support streamable HTTP).

What MCP tools does DevServer MCP expose?

Server management tools: start_server, stop_server, get_server_status, get_server_logs. Experimental browser automation tools (when Playwright is enabled): browser_navigate, browser_snapshot, browser_console_messages.