mcpField
T
tidyports

tidyports

ローカル
github.com/dan-fetch-studio開発ツール013 週間前に更新
リポジトリ

tidyports について

tidyports integrationsは、コーディングエージェントがローカルの開発サーバーを確認・管理するための連携機能です。複数のGitワークツリーを並行利用する際、ワークツリーごとの固定ポート割り当てや競合プロセスの特定にも対応します。

主な機能

  1. 01開発サーバー、ポート、所有プロセスの一覧表示
  2. 02指定ポートのサーバー停止
  3. 03ワークツリーごとの固定ポート割り当て
  4. 04現在使用されていないポートの検索
  5. 05guardでポート使用中のプロセスを特定

活用シーン

  1. 01並行ワークツリー間のポート競合の調査
  2. 02コーディングエージェントが起動したサーバーの確認
  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 の連携機能

コーディングエージェントが、起動したローカルの開発サーバーを確認して制御できるようにします。

複数の Git ワークツリーで Claude Code、Cursor、Codex を実行していると、それぞれがコマンドを入力した覚えのない開発サーバーを起動します。ポートが競合し、EADDRINUSE に遭遇したエージェントは、ポートの競合とバグを区別できないことが多いため、動作しているコードを「修正」してしまいます。

これらの連携機能を使えば、エージェントは推測するのではなく、状況を確認できます。

mcp/MCP サーバーです。あらゆる MCP クライアント（Claude Code、Cursor、Claude Desktop、Windsurf、Zed）向けの型付きツールを提供します。
skills/CLI を直接実行させたい場合に使える、Claude Code スキルです。
guard/開発コマンドをラップします。EADDRINUSE が、ポートを使用しているものがあるとだけ示すのではなく、何がポートを使用しているのかを表示します。
raycast/ランチャーを離れずに同じリストを確認できる、Raycast 拡張機能です。

ツール

ツール説明
list_servers接続待ち状態の開発サーバーを一覧表示します。ポート、プロセス、ブランチ、所有者、アイドル状態を確認できます。読み取り専用です。
kill_port指定したポートのサーバーを停止します。
alloc_portこのワークツリー用の、安定した競合のないポートを割り当てます。並行して動作するエージェントが :3000 を奪い合う問題を解決します。
free_port現在何も接続待ちしていないポートを取得し、すぐにバインドできます。

インストール

あらゆるエージェント（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 アプリが必要です

これらは、TidyPorts に同梱されている tidy-ports CLI を利用する薄いレイヤーです。TidyPorts は、Mac で実行中のすべての開発サーバーと、それを起動したエージェントを表示する、無料のメニューバーアプリです。

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

または、tidyports.app/download からダウンロードしてください。macOS 15 以降が必要です。

ライセンス

ここにある連携機能は MIT ライセンスです（LICENSE を参照）。TidyPorts アプリ自体は、独自のライセンスの下でソースコードを公開しています。

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。