DevPilot

Dev server supervisor for AI coders.

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

  • Devpilot Status: Check health status of dev server services. Returns live health check results including status, response time, and configuration for all registered services or a specific one. Args: s
  • Devpilot Changed: Report a file change and check if the dev server reloaded successfully. Call this AFTER editing a file. Returns which service was affected, reload status (reloaded/reload_failed/time
  • Devpilot Run: Start and manage a dev server process. Spawns the process, captures stdout, detects reload patterns, monitors health, and auto-recovers from crashes. Supports FastAPI, Flask, Django, Vit

What data it sees

Do you need an account

No: the server works without sign-in

Dev server supervisor for AI coders. Manages dev server lifecycles, detects reloads, checks health, and recovers from crashes. 10 MCP tools for full lifecycle management. Best used as a local stdio server (pip install devpilot-ai[mcp]) since it needs access to your machine processes and ports.

How to connect

How to connect DevPilot to Claude

The server address to paste into Claude settings:

https://devpilot--benzsevern.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect DevPilot to ChatGPT

The server address to paste into ChatGPT settings:

https://devpilot--benzsevern.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect DevPilot to Cursor

The server address to paste into Cursor settings:

https://devpilot--benzsevern.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (10)

Raw names from tools/list. Only developers need these.

devpilot_statusCheck health status of dev server services. Returns live health check results including status, response time, and configuration for all registered services or a specific one. Args: service_name: Name of a specific service to check. Omit to check all.
devpilot_changedReport a file change and check if the dev server reloaded successfully. Call this AFTER editing a file. Returns which service was affected, reload status (reloaded/reload_failed/timeout), and health. This is the primary feedback loop for AI coders. Args: filepath: Path of the changed file relative to project root. verify_endpoint: Optional HTTP endpoint to hit after reload, e.g. "/api/hello". timeout: Max seconds to wait for reload detection. Default 15.
devpilot_runStart and manage a dev server process. Spawns the process, captures stdout, detects reload patterns, monitors health, and auto-recovers from crashes. Supports FastAPI, Flask, Django, Vite, Next.js, and CRA with auto-detected defaults. Args: name: Unique service name, e.g. "api" or "frontend". cmd: Shell command to start the server, e.g. "uvicorn main:app --reload --port 8000". port: Port the server listens on. Auto-detected from framework if omitted. service_type: "backend" or "frontend". Auto-detected if omitted. health_endpoint: HTTP path for health checks, e.g. "/health". Uses TCP if omitted. file_patterns: Glob patterns for watched files, e.g. ["**/*.py"]. reload_patterns: Stdout patterns indicating a successful reload.
devpilot_attachAttach to an already-running dev server for health monitoring. Discovers the process by port but does NOT own or restart it. Use when the server was started externally. Args: name: Unique service name. port: Port the existing server listens on. service_type: "backend" or "frontend". cmd: Original start command (for reference only). health_endpoint: HTTP path for health checks.
devpilot_stopGracefully stop managed dev server services. Only stops services that devpilot started. Never kills processes it didn't start. Args: name: Name of a specific service to stop. stop_all: Set true to stop all managed services.
devpilot_initAuto-detect project structure and generate .devpilot.yaml config. Scans for pyproject.toml, requirements.txt, and package.json to detect frameworks (FastAPI, Flask, Django, Vite, Next.js, CRA) and generates appropriate service configuration.
devpilot_upStart all services defined in .devpilot.yaml. Reads the project config and starts each service under supervision with auto-recovery.
devpilot_logView recent devpilot events including auto-restarts, crashes, recoveries, and escalations. Args: service_name: Filter to a specific service. Omit for all events.
devpilot_cleanupRemove stale state entries for processes that are no longer running. Cleans up dead PIDs and orphan service registrations.
devpilot_health_checkPerform a direct health check on any port. Returns healthy/unhealthy status, HTTP status code, and response time. Works without registering a service. Args: port: Port number to check. endpoint: HTTP path like "/health". Uses raw TCP check if omitted.