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 分