Tidyports

io.github.dan-fetch-studio由 GitHub 账号 dan-fetch-studio 发布v0.1.2更新于 Oct 24, 2026

See and kill the dev servers your coding agents leave running, and get collision-free ports.

已验证STDIO仅桌面云端与基础设施开发者工具

概览

AI 生成的概览

让编码代理在 macOS 上查看、终止并分配本地开发服务器端口，避免多个工作树争抢 3000 之类的端口。

可以做什么
  • 列出正在监听的开发服务器，含端口、进程、分支、归属与空闲状态（只读）。
  • 停止占用指定端口的服务器。
  • 为当前工作树分配稳定的、不冲突的端口。
  • 获取当前无人监听、可立即绑定的空闲端口。
适用场景
适合多个代理或多个 git 工作树各自启动开发服务器、频繁遇到 EADDRINUSE 的场景，也适合代理把端口冲突误判为代码缺陷、去改动本来正常的代码时使用。它让代理能查看实际情况而不是靠猜。
运行要求
本地 npm 包（@tidyports/mcp），需在客户端注册为 tidyports-mcp 可执行文件。它是对 tidy-ports 命令行的薄封装，该命令行随 TidyPorts 这款 macOS 菜单栏应用（macOS 15+）提供，可通过 Homebrew cask 或厂商下载安装。仅限桌面端；未声明认证或环境变量。
安装前请注意
kill_port 会终止本机进程，代理可能关掉并非它启动的开发服务器，授权前请确认。它依赖单独的 macOS 应用与命令行，缺少这些则无法工作，且仅支持 macOS。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Tidyports，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

TidyPorts integrations

Let your coding agent see and control the local dev servers it starts.

If you run Claude Code, Cursor or Codex across several git worktrees, each one starts dev servers you never typed a command for. Ports collide, and an agent that hits EADDRINUSE often can't tell a port conflict from a bug — so it "fixes" working code instead.

These integrations give the agent a way to look, rather than guess.

mcp/An MCP server — typed tools for any MCP client (Claude Code, Cursor, Claude Desktop, Windsurf, Zed).
skills/A Claude Code skill, if you'd rather it shelled out to the CLI directly.
guard/Wrap your dev command so EADDRINUSE names what is holding the port, instead of only saying that something is.
raycast/A Raycast extension for the same list, without leaving the launcher.

Tools

ToolWhat it does
list_serversListening dev servers: port, process, branch, owner, idle. Read-only.
kill_portStop the server on a given port.
alloc_portA stable, collision-free port for this worktree — the fix for parallel agents fighting over :3000.
free_portA port nothing is listening on right now, to bind immediately.

Install

The skill, for any agent (Claude Code, Cursor, Copilot, Gemini…):

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

The MCP server:

sh
npm install -g @tidyports/mcp

Then register it with your client, pointing at the installed tidyports-mcp binary. For Claude Code:

sh
claude mcp add tidyports -- tidyports-mcp

It needs the TidyPorts app

These are a thin layer over the tidy-ports CLI, which ships inside TidyPorts — a free macOS menu-bar app that shows every dev server running on your Mac and which agent started it.

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

Or download it from tidyports.app/download. macOS 15+.

Licence

The integrations here are MIT (see LICENSE). The TidyPorts app itself is source-available under its own licence.

来源：README.md，提交 50e2761

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.1.2最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分