localhost app

@getlocalhost/cli

ターミナルから、コーディングエージェントを localhost app の MCP サーバーである localhost mcp に接続します。

npx @getlocalhost/cli mcp install

このツールは、このコンピューターにある Claude Code、Claude Desktop、Cursor、Codex に localhost という名前のサーバーを追加し、各エージェントがスキルを読み込む場所に localhost-mcp skill をインストールします。サーバーはアプリに付属する localhost コマンドを実行するため、アプリをインストールしておく必要があります。アプリがない場合は、OS ごとのインストール方法を表示し、何も変更しません。

アプリの Settings → Agents が書き込む内容と同じものを書き込み、アプリではこれらのエージェントが接続済みとして表示されます。

エージェント	MCP サーバーの追加先	スキルのインストール先
Claude Code	~/.claude.json。claude がインストールされている場合は claude mcp add-json --scope user を使用	~/.claude/skills/localhost-mcp/
Claude Desktop（macOS、Windows）	Claude のフォルダー（~/Library/Application Support/Claude、%APPDATA%\Claude）にある claude_desktop_config.json	なし：スキルフォルダーがありません
Cursor	~/.cursor/mcp.json	~/.cursor/skills/localhost-mcp/。ただし、Claude Code または Codex のフォルダーにスキルがある場合を除きます。Cursor はそちらも読み込みます
Codex	~/.codex/config.toml	~/.agents/skills/localhost-mcp/

• このツールが追加した項目だけが対象です。 ファイル内のほかのサーバーや設定は、コメントや順序も含め、そのまま保持されます。読み取れないファイルがある場合は、その旨を報告して変更しません。
• 変更前にバックアップします。 localhost のデータフォルダーにある agent-backups フォルダーに、ファイルを初めて変更する前にバックアップを作成します。
• 再度実行しても何も変更しません。

コマンド

npx @getlocalhost/cli mcp install     # add the server and the skill
npx @getlocalhost/cli mcp uninstall   # remove them, and nothing else
npx @getlocalhost/cli mcp status      # where each agent stands
npx @getlocalhost/cli mcp serve       # run the server, for an MCP client's configuration

オプション
--client <agent>	claude-code、claude-desktop、cursor、codex のいずれか。両方の Claude アプリを指定する場合は claude を使います。複数指定するには、繰り返すか、カンマで区切ります。指定しない場合は、このコンピューターで見つかったすべてのエージェントが対象です。
--read-only	mcp install と mcp serve で使用します。サーバーは localhost mcp --read-only を実行し、プロジェクトやサービスの追加、編集、削除を行うツールを無効にします。この機能に対応した localhost アプリ（0.4.0 以降）が必要です。このオプションを付けずに再インストールしても、読み取り専用のサーバーはそのまま読み取り専用です。
--dry-run	変更内容を差分として表示し、何も変更しません。

その後、新しい Claude Code セッションを開始するか、Claude Desktop を終了して再起動するか、Cursor Settings → MCP を確認するか、Codex を再起動してください。

任意の MCP クライアント

mcp serve は、stdio 経由で MCP サーバーを起動する任意のクライアントで使えるサーバー本体です。

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

mcp install と同じ方法でアプリの localhost コマンドを見つけ、クライアントの標準入力と標準出力を渡して localhost mcp を実行します。Ctrl-C やその他のシグナルを転送し、サーバーと同じ終了コードで終了します。mcp serve --read-only は localhost mcp --read-only を実行します。標準出力はクライアントの通信チャネルであるため、このコマンド自体は何も書き込みません。アプリがない場合、またはアプリのコマンドが実行できない場合は、その理由を標準エラー出力に表示して、終了コード 1 で終了します。claude mcp add --scope user localhost -- npx -y @getlocalhost/cli mcp serve および codex mcp add localhost -- npx -y @getlocalhost/cli mcp serve を実行すると、ターミナルから追加できます。

詳しくは MCP docs をご覧ください。Node 18 以降が必要です。依存関係はありません。

開発

cd packages/cli
npm test
node bin/getlocalhost.js mcp status

JSON エディターと TOML エディターはコア（core/localhost-core/src/agents/）のものと同じで、テストも共通です。両方を一緒に変更してください。npm pack は、スキルを skills/localhost-mcp からパッケージにコピーします。