MCP 端口清理服务器
基于 Node.js 实现的服务器，遵循模型上下文协议（Model Context Protocol, MCP），用于在开发环境中执行端口清理操作。
功能特性
- 查找并终止占用指定端口的进程
- 扫描并列出占用指定端口的所有进程（支持跨平台）
- 使用 Zod 模式进行安全的输入参数验证
- 详细的错误处理和响应格式化
- 符合标准的 MCP 协议，支持工具注册和请求处理
工具
port_scan
描述: 扫描并列出占用指定端口的所有进程（支持跨平台）。
输入参数:
响应:
- 成功: 返回包含详细信息的进程列表（PID、名称、用户、协议）
- 失败: 返回错误信息
- 端口未被占用: 返回相应的通知
port_clean
描述: 查找并终止占用指定端口的进程，以解决开发环境中的端口冲突问题。
输入参数:
响应:
- 成功: 返回被终止的进程 ID 列表
- 失败: 返回错误信息
- 端口未被占用: 返回相应的通知
使用示例
与 Claude Desktop 或 Trae.cn 配合使用
Docker 配置
待补充
NPX 配置
或者全局安装：
然后使用：
实现细节
服务器实现了以下组件：
- PortCleanerService: 端口清理操作的核心业务逻辑
- PortScannerService: 跨平台的端口扫描功能
- MCP 服务器集成: 标准 MCP 协议实现，包括：
- 工具注册（
port_clean、port_scan） - 请求处理
- 输入验证
- 错误处理: 在服务和服务器层面提供全面的错误处理
错误处理
服务器在所有失败场景下提供详细的错误响应：
- 无效的输入参数
- 进程终止失败
- 意外的运行时错误
开发说明
- 服务使用平台特定的命令：
- Linux/Unix:
lsof、kill、netstat - Windows:
netstat、tasklist、taskkill
- 通过进程检测实现跨平台兼容性
- 清理实现使用 SIGKILL（-9）终止进程
许可证
本 MCP 服务器遵循 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但需遵守 MIT 许可证的条款和条件。更多详情，请参阅项目仓库中的 LICENSE 文件。
- Author:waytomcp
- URL:https://www.waytomcp.com/article/BrightLin/mcp-server-port-cleaner
- Copyright:All articles in this blog, except for special statements, adopt BY-NC-SA agreement. Please indicate the source!
