Crate task_mcp 

Task MCP

An MCP server to prevent agents from losing track of all the dev servers they spawn, thus burning through port numbers and running pkill indiscriminately.

[!WARNING] This server currently has a bug whereby it also loses track of tasks. See ./tbd/connection-bug.md.

Sample

You may wish to paste something like the following into AGENTS.md or CLAUDE.md:

## Process Management

Use the MCP task server for background processes, not raw bash backgrounding
or pkill. This includes dev servers, watch processes, and any long-running
commands.

- `task_ensure` to start (idempotent - safe to call if already running)
- `task_list` to see what's running
- `task_logs` to check output
- `task_stop` to stop cleanly

Never use `pkill`, `kill`, or `&` backgrounding for process management.

Structs

TaskEnsureArgs

Arguments for the task_ensure tool.

TaskEnsureResult

Result of task_ensure.

TaskInfo

Information about a managed task.

TaskListResult

Result of task_list.

TaskLogsArgs

Arguments for the task_logs tool.

TaskLogsResult

Result of task_logs.

TaskManager

Manages the collection of tracked tasks.

TaskMcpServer

MCP server for managing background tasks.

TaskStatus

Status information for a task.

TaskStopArgs

Arguments for the task_stop tool.

TaskStopResult

Result of task_stop.

Enums

Error

Errors that can occur during task management.

Type Aliases

Result

A specialized Result type for task-mcp operations.