PM-MCP (进程管理器 MCP)

一个模型上下文协议（MCP）服务器，允许Claude和其他大型语言模型管理长时间运行的bash进程。非常适合在开发会话期间管理开发服务器、构建过程和其他后台任务。

功能

• 启动进程：以名称和描述启动长时间运行的bash命令
• 进程管理：终止单个进程或一次性终止所有进程
• 日志管理：捕获、检索和搜索stdout/stderr日志
• 进程交互：向正在运行的进程发送输入
• 故障检测：立即报告无法启动的进程错误
• CLI工具：独立的命令行界面用于进程管理
• 持久日志记录：所有进程日志都保存到磁盘以便后续检索

安装

npm install -g pm-mcp

使用方法

作为MCP服务器

配置您的MCP客户端以使用此服务器：

{
  "mcpServers": {
    "pm-mcp": {
      "command": "npx",
      "args": ["pm-mcp"]
    }
  }
}

可用的MCP工具

1. start_process - 启动新进程

   • name（必需）：用于标识进程的名称
   • command（必需）：要执行的bash命令
   • description（可选）：进程描述
   • cwd（可选）：工作目录

2. terminate_process - 停止特定进程

   • id（必需）：要终止的进程ID

3. terminate_all_processes - 停止所有管理的进程

4. list_processes - 列出所有进程

   • id（可选）：获取特定进程的信息

5. get_logs - 检索进程日志

   • id（必需）：进程ID
   • lines（可选）：最近的行数

6. grep_logs - 搜索进程日志

   • id（必需）：进程ID
   • pattern（必需）：正则搜索模式

7. send_input - 向正在运行的进程发送输入

   • id（必需）：进程ID
   • input（必需）：要发送的输入字符串

CLI工具

# 启动进程
npx pm-mcp cli start "dev-server" "npm run dev" --description "开发服务器"

# 列出所有进程
npx pm-mcp cli list

# 获取日志
npx pm-mcp cli logs <进程ID>

# 搜索日志
npx pm-mcp cli grep <进程ID> "error"

# 向进程发送输入
npx pm-mcp cli input <进程ID> "一些输入"

# 终止进程
npx pm-mcp cli terminate <进程ID>

# 终止所有进程
npx pm-mcp cli terminate-all

示例使用与Claude

Claude: 我将为您启动开发服务器。

用户: 在3000端口启动一个React开发服务器，并在8080端口启动一个API服务器

Claude: 我将为您启动这两个服务器。

[使用start_process工具]
- 名称："react-dev"
- 命令："npm run dev"
- 描述："在3000端口运行的React开发服务器"

[使用start_process工具]
- 名称："api-server"
- 命令："npm run api:dev"
- 描述："在8080端口运行的API开发服务器"

两个服务器现在都在运行。您可以随时检查它们的日志或终止它们。

用户: 检查React服务器是否有任何错误

Claude: [使用grep_logs工具，模式为"error"]
未在React服务器日志中发现错误。

用户: 发送"q"来退出API服务器

Claude: [使用send_input工具]
已向API服务器进程发送"q"。

日志文件

进程日志存储在./pm-mcp-logs/目录中，格式为<进程ID>.log。每个日志条目包括：

• 时间戳
• 流类型（stdout/stderr）
• 日志内容

开发

# 构建项目
npm run build

# 开发监视模式
npm run dev

# 运行MCP服务器
npm start

# 使用CLI
npx pm-mcp cli --help

架构

• ProcessManager：核心类处理进程生命周期、日志记录和管理
• MCP服务器：通过MCP协议暴露进程管理功能
• CLI工具：独立接口用于直接进程管理
• 日志记录：基于文件的持久日志记录，带有时间戳和流类型跟踪