dev

Run your MCP server locally with hot reload and the inspector.

mcp-use dev [--port <port>] [--no-open] [--no-hmr] [--tunnel]

Starts the dev server with hot module replacement and automatically opens the MCP Inspector at http://localhost:<port>/inspector, where you can chat with your server and call its tools. No login required.

FlagDescription
--port <port>Port to listen on (default 3000).
--entry <file> / --mcp-dir <dir>Point at a custom server entry or an MCP folder inside a larger app.
--no-openDon't auto-open the inspector.
--no-hmrRestart the process on change instead of HMR.
--tunnelExpose the dev server on a public URL so remote clients can connect.

To scaffold a new project first, use npx create-mcp-use-app my-app. When ready to ship; use deploy.