MCP Port Cleaner Server

MCP Port Cleaner Server

開発環境でポートをクリーンアップするための Model Context Protocol（MCP）を実装した Node.js サーバーです。

特長

• 指定したポートを使用しているプロセスを検出して終了します
• 指定したポートを使用しているすべてのプロセスをスキャンして一覧表示します（クロスプラットフォーム対応）
• Zod スキーマを使用して入力パラメーターを安全に検証します
• 詳細なエラー処理とレスポンスのフォーマットを提供します
• ツールの登録とリクエスト処理に関する標準 MCP プロトコルに準拠しています

ツール

port_scan

説明：指定したポートを使用しているすべてのプロセスをスキャンして一覧表示します（クロスプラットフォーム対応）。

入力パラメーター：

{
  "port": {
    "type": "integer",
    "description": "scan process by specify port",
    "minimum": 1,
    "maximum": 65535
  }
}

レスポンス：

• 成功：プロセスの詳細（PID、名前、ユーザー、プロトコル）の一覧を返します
• 失敗：エラー情報を返します
• ポートが使用されていない場合：適切な通知を返します

port_clean

説明：開発環境でのポートの競合を解消するため、指定したポートを使用しているプロセスを検出して終了します。

入力パラメーター：

{
  "port": {
    "type": "integer",
    "description": "clean process by specify port",
    "minimum": 1,
    "maximum": 65535
  }
}

レスポンス：

• 成功：終了したプロセス ID の一覧を返します
• 失敗：エラー情報を返します
• ポートが使用されていない場合：適切な通知を返します

使用例

Claude Desktop または Trae.cn で使用する場合

Docker の設定

TODO

NPX の設定

{
  "mcpServers": {
    "port-cleaner": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-port-cleaner"
      ]
    }
  }
}

または、グローバルにインストールします：

npm install -g mcp-server-port-cleaner

次に、以下を実行します：

{
  "mcpServers": {
    "port-cleaner": {
      "command": "mcp-server-port-cleaner"
    }
  }
}

実装の詳細

サーバーは以下のコンポーネントを実装しています。

1. PortCleanerService：ポートのクリーンアップ処理を行う中核的なビジネスロジック
2. PortScannerService：クロスプラットフォームのポートスキャン機能
3. MCP サーバーとの統合：以下を備えた標準 MCP プロトコルの実装
   • ツールの登録（port_clean、port_scan）
   • リクエストの処理
   • 入力の検証
4. エラー処理：サービスとサーバーの両方のレベルで包括的にエラーを処理します

エラー処理

サーバーは、すべての失敗シナリオで詳細なエラーレスポンスを提供します。

• 無効な入力パラメーター
• プロセスの終了に失敗した場合
• 予期しない実行時エラー

開発上の注意

• このサービスでは、プラットフォーム固有のコマンドを使用します。
  • Linux/Unix：lsof、kill、netstat
  • Windows：netstat、tasklist、taskkill
• プロセスの検出により、クロスプラットフォーム互換性を実現しています
• クリーンアップ処理では、SIGKILL（-9）を使用してプロセスを終了します

ライセンス

この MCP サーバーは MIT License のもとでライセンスされています。MIT License の利用規約に従うことを条件に、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリ内の LICENSE ファイルをご覧ください。