MCP Port Cleaner Server

MCP 端口清理服务

使用 Node.js 实现的 MCP 服务，用于在开发环境中清理端口。

功能

• 查找并终止占用指定端口的进程
• 扫描并列出所有占用指定端口的进程（支持跨平台）
• 使用 Zod schema 安全地验证输入参数
• 提供详细的错误处理和响应格式
• 符合标准 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 配置

待办

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 文件。