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 SSE - HTTP server: Serves
/sse
endpoint for Claude Code connections on specified port - Error 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.