localhost app

io.github.marcellossoPublished by GitHub account marcellossov0.2.0Updated Nov 4, 2026

Start, stop and read logs of your local dev servers from Claude Code, Cursor and Codex.

VerifiedSTDIODesktop onlyCloud & InfrastructureDeveloper Tools

Overview

AI-generated overview

Connects coding agents to the localhost app so they can start, stop and read logs of local dev servers on your machine.

What you can do
  • Start, stop and read logs of local dev servers through the localhost app
  • Add, edit or remove Projects and Services, unless the server is run read-only
  • Install, uninstall and check the MCP server and skill across Claude Code, Claude Desktop, Cursor and Codex
  • Run the server over stdio for any MCP client, with optional read-only mode and dry-run previews
When to use it
Useful when you work with local dev servers and want a coding agent to launch, stop or inspect their logs without leaving the chat, and when you want the server wired into several agents at once.
Requirements
The localhost app must be installed, since the server runs the app's localhost command; read-only mode needs app 0.4.0 or later. Node 18 or later, run via npx with no dependencies. No authentication, environment variables or headers are declared.
Before you install
The installer writes to agent configuration files such as ~/.claude.json, claude_desktop_config.json, ~/.cursor/mcp.json and ~/.codex/config.toml, and installs a skill folder; it backs up files first and leaves other entries untouched. Without read-only mode the server can add, edit or remove Projects and Services. Use dry-run to preview changes.

Installation

In SourceWeft

  1. Open localhost app in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@getlocalhost/cli

Connects your coding agents to localhost mcp, the MCP server of localhost app, from a terminal:

sh
npx @getlocalhost/cli mcp install

It adds a server named localhost to Claude Code, Claude Desktop, Cursor and Codex, whichever are on this computer, and installs the localhost-mcp skill where each agent reads skills. The server runs the localhost command that comes with the app, so the app must be installed: without it, this prints how to install it for your OS and changes nothing.

It writes what Settings → Agents in the app writes, and the app shows these agents as connected:

AgentMCP server added toSkill installed in
Claude Code~/.claude.json, through claude mcp add-json --scope user when claude is installed~/.claude/skills/localhost-mcp/
Claude Desktop (macOS, Windows)claude_desktop_config.json in Claude's folder (~/Library/Application Support/Claude, %APPDATA%\Claude)none: it has no skills folder
Cursor~/.cursor/mcp.json~/.cursor/skills/localhost-mcp/, unless Claude Code's or Codex's folder has it: Cursor reads those too
Codex~/.codex/config.toml~/.agents/skills/localhost-mcp/
  • Only its own entries. Every other server and setting in the file stays as it was, comments and order included. A file it can't read is reported and left alone.
  • A backup first, in the agent-backups folder of localhost's data folder, before it first changes a file.
  • Running it again changes nothing.

Commands

sh
npx @getlocalhost/cli mcp install     # add the server and the skillnpx @getlocalhost/cli mcp uninstall   # remove them, and nothing elsenpx @getlocalhost/cli mcp status      # where each agent standsnpx @getlocalhost/cli mcp serve       # run the server, for an MCP client's configuration
Option
--client <agent>claude-code, claude-desktop, cursor or codex; claude for both Claude apps. Repeat it, or separate with commas, for more than one. Without it: every agent found on this computer.
--read-onlyFor mcp install and mcp serve. The server runs localhost mcp --read-only, without the tools that add, edit or remove Projects and Services. Needs a localhost app that has it (0.4.0 or later). Installing again without it keeps a read-only server read-only.
--dry-runPrints what would change, as a diff, and changes nothing.

Then start a new Claude Code session, quit and reopen Claude Desktop, check Cursor Settings → MCP, or restart Codex.

Any MCP client

mcp serve is the server itself, for any client that starts MCP servers over stdio:

json
{  "mcpServers": {    "localhost": { "command": "npx", "args": ["-y", "@getlocalhost/cli", "mcp", "serve"] }  }}

It finds the app's localhost command as mcp install does and runs localhost mcp with the client's stdin and stdout, passing on Ctrl-C and other signals and exiting as the server does. mcp serve --read-only runs localhost mcp --read-only. It writes nothing to stdout itself, since that is the client's channel: without the app, or with an app whose command doesn't run, it says why on stderr and exits with 1. claude mcp add --scope user localhost -- npx -y @getlocalhost/cli mcp serve and codex mcp add localhost -- npx -y @getlocalhost/cli mcp serve add it from a terminal.

More in the MCP docs. Node 18 or later; no dependencies.

Development

sh
cd packages/clinpm testnode bin/getlocalhost.js mcp status

The JSON and TOML editors are the same as the core's (core/localhost-core/src/agents/), and their tests too: change both together. npm pack copies the skill from skills/localhost-mcp into the package.

Source: packages/cli/README.md at commit 2ec6435

Tools

0
SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the server did not start.

Version history

1
  1. v0.2.0LatestNov 4, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts