pm MCP

PM-MCP（过程经理MCP）

一种模型上下文协议（MCP）服务器，允许Claude和其他LLM管理长时间运行的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 （可选）：工作目录

1. 终止进程 -停止特定进程

- id （必填）：要终止的进程ID

1. 终止所有流程 -停止所有托管进程

1. 列表_流程 -列出所有流程

- id （可选）：获取特定流程的信息

1. get_logs -检索流程日志

- id （必填）：进程ID - lines （可选）：最近行数

1. grep_logs -搜索进程日志

- id （必填）：进程ID - pattern （必填）：正则表达式搜索模式

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

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

CLI工具

# Start a process
npx pm-mcp cli start "dev-server" "npm run dev" --description "Development server"

# List all processes
npx pm-mcp cli list

# Get logs
npx pm-mcp cli logs 

# Search logs
npx pm-mcp cli grep 
 "error"

# Send input to process
npx pm-mcp cli input 
 "some input"

# Terminate process
npx pm-mcp cli terminate 

# Terminate all processes
npx pm-mcp cli terminate-all

Claude使用示例

Claude: I'll start your development servers for you.

User: Start a React dev server on port 3000 and an API server on port 8080

Claude: I'll start both servers for you.

[Uses start_process tool]
- Name: "react-dev"
- Command: "npm run dev"
- Description: "React development server on port 3000"

[Uses start_process tool]  
- Name: "api-server"
- Command: "npm run api:dev"
- Description: "API development server on port 8080"

Both servers are now running. You can check their logs or terminate them anytime.

User: Check if there are any errors in the React server

Claude: [Uses grep_logs tool with pattern "error"]
No errors found in the React server logs.

User: Send "q" to quit the API server

Claude: [Uses send_input tool]
Input "q" sent to the API server process.

日志文件

流程日志存储在 ./pm-mcp-logs/ 格式为的目录 .log。每个日志条目包括：

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

发展

# Build the project
npm run build

# Watch mode for development
npm run dev

# Run the MCP server
npm start

# Use the CLI
npx pm-mcp cli --help

建筑

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