Tracks and categorizes Svelte component warnings and errors during development, enabling immediate debugging assistance
Monitors and categorizes TypeScript compilation errors in real-time, providing structured error data with file locations and severity classification
Monitors Vite build failures and development server issues, providing real-time error notifications and categorization
DevServer MCP
An MCP server that monitors development server logs in real-time, categorizes errors by type and severity, and provides Claude Code with immediate error notifications via Server-Sent Events (SSE).
DevServer MCP:
Real-time notifications: Instant error alerts via SSE transport
Intelligent parsing: Recognizes TypeScript, Svelte, Vite error patterns
Error correlation: Links errors to recent file changes
Severity classification: Critical vs warning vs info
Multiple client support: Connect multiple Claude Code instances simultaneously
AI integration: Claude Code receives structured error data instead of raw logs
Quick Start
Now Claude Code receives immediate notifications when errors occur!
Core Workflow
Traditional debugging:
Notice something broken → 2. Scroll through terminal → 3. Find relevant error → 4. Google it
With DevServer MCP:
Error occurs → 2. Instant notification in Claude Code → 3. Get categorized errors with file locations → 4. Ask "How do I fix this?"
MCP Tools
get_dev_server_status
- Current server health and error countsget_error_summary
- Errors grouped by type/severityget_error_history
- Chronological error list with filteringget_file_errors
- Errors for a specific filesuggest_monitoring_setup
- Project-specific setup recommendations
Port Configuration
Default Port (9338):
Custom Port Per Project:
Benefits:
✅ Consistent ports - same port every restart, no need to re-add MCP server
✅ Per-project ports - run multiple projects simultaneously
✅ Conflict detection - helpful error messages if port is already in use
Architecture
SSE-Based Real-Time System:
Monitor mode (
--monitor
): Spawns dev server, parses logs, broadcasts errors via SSEHTTP server: Serves
/sse
endpoint for Claude Code connections on specified portError buffering: Maintains recent error history for newly connected clients
Multi-client support: Multiple Claude Code instances can connect simultaneously
Real-time error streaming means Claude Code gets notified within 1-2 seconds of any dev server issue.
Error Categories
Built-in patterns for:
TypeScript compilation errors
Svelte component warnings
Vite build failures
Network/API errors
Runtime JavaScript errors
Accessibility issues
Configuration
Create devserver-mcp.config.json
:
Development
Troubleshooting
Connection Failed
Port Already in Use
No Real-Time Notifications
Multiple Projects
License
MIT
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Monitors development server logs in real-time and provides Claude with immediate error notifications via Server-Sent Events. Intelligently parses TypeScript, Svelte, and Vite errors with severity classification and file correlation.