@waylaidwanderer
A Model Context Protocol (MCP) server that provides background process management capabilities. This server enables LLMs to start, stop, and monitor long-running command-line processes.
使用下面的配置,将此服务器添加到你的 MCP 客户端。
{
"mcpServers": {
"backgroundProcess": {
"command": "npx",
"args": [
"@waylaidwanderer/background-process-mcp@latest"
]
}
}
}Starts a new process in the background.
Stops a running process.
Clears a stopped process from the list.
Gets the recent output for a process. Can specify `head` for the first N lines or `tail` for the last N lines.
Gets a list of all processes being managed by the Core Service.
Gets the current status of the Core Service.
Background Process MCP is a Model Context Protocol server that provides background process management capabilities. It enables LLM agents to start, stop, and monitor long-running command-line processes, and includes a terminal UI (TUI) for manual monitoring.
Install the server via npx @waylaidwanderer/background-process-mcp@latest in any MCP client (Claude Code, Claude Desktop, Cursor, Gemini CLI, etc.). For a standalone server, add the --port argument. Alternatively, install globally (pnpm add -g @waylaidwanderer/background-process-mcp) and use the bgpm command to run the core service (bgpm server) or the TUI (bgpm ui --port <port_number>).
Some AI agents like Claude Code can manage background processes natively, but many others (e.g., Gemini CLI) cannot. This project provides that capability as a standard MCP tool, making long-running task management available to a wider range of agents.
The server uses `node-pty` for child process lifecycle management and runs as a Node.js application. It is distributed as an npm package and executed via `npx` or a global install.
The Core Service (`src/server.ts`) is a standalone WebSocket server that acts as the single source of truth for all process states. The MCP client connects to it, either spawning a new instance or attaching to an existing one.
The MCP server uses the standard STDIO transport for MCP communication. The underlying Core Service communicates over WebSocket. No authentication method is documented.
Yes. You can run the core service manually with `npx @waylaidwanderer/background-process-mcp server` and connect a TUI client via `npx … ui --port <port>`. The core service is standalone, allowing other custom clients to be built.
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
Model Context Protocol Servers
Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov
A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
评论