tao-izm/devpulse-mcp
📇 🏠 - Zero-config MCP server that gives AI coding assistants a real-time diagnostic snapshot of your local dev environment. Detects framework, running services, recent errors, and git state in one call.
Quick Install
{
"mcpServers": {
"tao-izm-devpulse-mcp": {
"command": "npx",
"args": [
"-y",
"tao-izm-devpulse-mcp"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
devpulse
An MCP server that lets your AI coding assistant see what's actually happening in your dev environment.
When you're debugging with Claude Code or Cursor, the AI has no idea if your dev server is running, what errors just appeared in the logs, or what branch you're on. You end up copy-pasting the same context every session. devpulse fixes that with one tool call.
What your AI sees
{
"diagnosis": {
"health": "broken",
"primary_issue": "Port conflict — dev server cannot start",
"suggested_action": "Kill the process using that port or change your dev server port",
"confidence": "high"
},
"session": {
"project": "my-app",
"framework": "nextjs",
"branch": "feat/auth",
"uncommitted_files": 3
},
"services": {
"running": [],
"expected_but_missing": [3000]
},
"recent_errors": [
{ "time": "2m ago", "level": "ERROR", "message": "EADDRINUSE :::3000" }
],
"env": {
"node": "20.11.0",
"package_manager": "pnpm"
}
}
Instead of asking you what's wrong, the AI already knows.
Setup
Claude Code
claude mcp add devpulse -- npx -y devpulse-mcp
Cursor / Claude Desktop / Windsurf
{
"mcpServers": {
"devpulse": {
"command": "npx",
"args": ["-y", "devpulse-mcp"]
}
}
}
No API key. No account. No config file.
Tools
get_session_snapshot— full diagnostic snapshot, call this firstget_recent_errors— recent errors from your log files, secrets redactedget_running_services— what's on your dev ports and what's missing
Supported frameworks
Detected automatically from your package.json — Next.js, Vite, Express, FastAPI. More coming.
Privacy
Runs entirely on your machine. No data leaves your computer. API keys and secrets are automatically stripped from log output.
License
MIT