mcpField
T
tidyports

tidyports

本地服务
github.com/dan-fetch-studio开发工具013 周前更新
代码仓库

关于 tidyports

tidyports integrations 为编码 Agent 提供查看和管理本地开发服务器的集成，适用于并行使用多个工作树的开发场景。它还可为工作树分配稳定端口，并在端口冲突时指出占用进程。

主要功能

  1. 01列出开发服务器、端口与所属进程
  2. 02停止指定端口上的服务器
  3. 03为工作树分配稳定端口
  4. 04查找当前空闲端口
  5. 05通过 guard 标出端口占用者

适用场景

  1. 01排查并行工作树的端口冲突
  2. 02查看编码 Agent 启动的开发服务器
  3. 03释放被服务器占用的端口

MCP 相关

MCP 服务向客户端提供 list_servers、kill_port、alloc_port 和 free_port 工具，以查看服务器并管理端口。集成依赖 TidyPorts 应用内提供的 tidy-ports CLI。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "dan-fetch-studio-tidyports": {
      "command": "npx",
      "args": [
        "-y",
        "@tidyports/mcp"
      ]
    }
  }
}
启动命令npx -y @tidyports/mcp

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

安装包
npm@tidyports/mcp0.1.2

工具

4

收录的工具列表 · 更新于 3 周前

此工具无需参数。

详细介绍

TidyPorts 集成

让编码 Agent 查看并控制它启动的本地开发服务器。

如果你在多个 Git 工作树中使用 Claude Code、Cursor 或 Codex，每个工作树都会启动一些你从未手动输入命令启动的开发服务器。端口会冲突，而遇到 EADDRINUSE 的 Agent 往往分不清是端口冲突还是代码错误，于是就会“修复”本来正常的代码。

这些集成让 Agent 可以查看情况，而不是靠猜。

mcp/一个 MCP 服务，为任何 MCP 客户端（Claude Code、Cursor、Claude Desktop、Windsurf、Zed）提供类型化工具。
skills/一个 Claude Code 技能，如果你更希望它直接通过命令行运行。
guard/包装你的开发命令，让 EADDRINUSE 报错指出占用端口的进程，而不只是说端口已被占用。
raycast/一个 Raycast 扩展，可在启动器中查看相同的列表。

工具

工具说明
list_servers正在监听的开发服务器：端口、进程、分支、所有者、空闲状态。只读。
kill_port停止指定端口上的服务器。
alloc_port为此工作树分配一个稳定且不会冲突的端口，解决并行 Agent 争用 :3000 的问题。
free_port查找当前没有进程监听、可立即绑定的端口。

安装

适用于任何 Agent（Claude Code、Cursor、Copilot、Gemini……）的技能：

npx skills add dan-fetch-studio/tidyports-integrations

MCP 服务：

npm install -g @tidyports/mcp

然后向客户端注册，并将其指向已安装的 tidyports-mcp 二进制文件。Claude Code 的配置示例：

claude mcp add tidyports -- tidyports-mcp
需要 TidyPorts 应用

这些集成是 tidy-ports CLI 的轻量封装。该 CLI 随 TidyPorts 提供，这是一个免费的 macOS 菜单栏应用，可显示 Mac 上运行的所有开发服务器及启动它们的 Agent。

brew install --cask dan-fetch-studio/tap/tidyports

也可以从 tidyports.app/download 下载。需要 macOS 15+。

许可

这里的集成采用 MIT 许可（参见 LICENSE）。TidyPorts 应用本身以其独立许可提供源代码。

评论

支持 Markdown

第一次接触 MCP？

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

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