mcpField
L
localhost app

localhost app

本地服务
getlocalhost.app开发工具13 天前更新
代码仓库访问官网

关于 localhost app

localhost app 的命令行工具可为同一台设备上的编码 Agent 配置其 MCP 服务和技能。它支持安装、移除、状态检查，也能为任意基于 stdio 的 MCP 客户端启动服务，同时保留其他配置。

主要功能

  1. 01安装或移除服务与技能配置
  2. 02检查 Agent 连接状态
  3. 03通过 stdio 启动 MCP 服务
  4. 04只读服务选项
  5. 05预览配置变更
  6. 06修改前备份配置文件

适用场景

  1. 01让 Claude Code、Cursor 或 Codex 连接 localhost
  2. 02为其他 stdio MCP 客户端配置服务
  3. 03应用前预览配置变更
  4. 04检查或移除现有 Agent 配置

MCP 相关

该命令行工具为受支持的 Agent 安装和管理 localhost app 的 MCP 服务配置。serve 命令通过 stdio 启动服务，供任意 MCP 客户端使用。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "marcellosso-localhost": {
      "command": "npx",
      "args": [
        "-y",
        "@getlocalhost/cli"
      ]
    }
  }
}
启动命令npx -y @getlocalhost/cli

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@getlocalhost/cli0.2.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

@getlocalhost/cli

从终端将编码 Agent 连接到 localhost mcp，即 localhost app 的 MCP 服务：

npx @getlocalhost/cli mcp install

它会在 Claude Code、Claude Desktop、Cursor 和 Codex 中添加一个名为 localhost 的服务，并在每个 Agent 读取技能的位置安装 localhost-mcp 技能。该服务会运行应用附带的 localhost 命令，因此必须先安装应用：如果未安装，它会显示适用于你操作系统的安装方法，并且不会更改任何内容。

它写入的内容与应用中的 Settings → Agents 相同，应用也会将这些 Agent 显示为已连接：

Agent添加 MCP 服务的位置安装技能的位置
Claude Code~/.claude.json；如果已安装 claude，则通过 claude mcp add-json --scope user 添加~/.claude/skills/localhost-mcp/
Claude Desktop（macOS、Windows）Claude 文件夹中的 claude_desktop_config.json（~/Library/Application Support/Claude、%APPDATA%\Claude）无：它没有技能文件夹
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 应用。可重复指定，或用逗号分隔，以指定多个 Agent。不指定时：选择此计算机上找到的所有 Agent。
--read-only适用于 mcp install 和 mcp serve。服务会运行 localhost mcp --read-only，不包含添加、编辑或移除 Projects 和 Services 的工具。需要使用包含此功能的 localhost app（0.4.0 或更高版本）。再次安装时若不指定此选项，已设为只读的服务仍会保持只读。
--dry-run以差异形式显示将要进行的更改，不会更改任何内容。

然后启动新的 Claude Code 会话，退出并重新打开 Claude Desktop，检查 Cursor Settings → MCP，或重启 Codex。

任何 MCP 客户端

mcp serve 是服务本身，可供任何通过标准输入输出启动 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 文档。需要 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 复制到软件包中。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。