mcp-process mcp

v1.0.0 · MCP Tool · system · registry.pascalai.org

Windows process management. Operations: list (running processes with optional name filter), get (process info by PID or name), kill (terminate by PID or name), start (fire-and-forget, returns PID), run (execute command synchronously and capture output), env (list environment variables with optional key filter).

processtasklisttaskkillwindowssystemshellenvironment

Input Parameters

ParameterTypeDescription
operationrequired string list: all processes. get/kill: need pid or name. start/run: need command. env: environment vars. One of: list, get, kill, start, run, env.
nameoptional string Process name for get/kill (e.g. "notepad.exe"). Also used as substring filter for list.
pidoptional integer Process ID for get/kill.
commandoptional string Command to execute. Required for start and run.
filteroptional string list: filter by process name substring. env: filter by key substring.
timeoutoptional integer run: timeout in milliseconds. Default: 30000. Default: 30000.

Output Fields

FieldTypeDescription
ok boolean
processes array[object]
count integer
found boolean
process object
pid integer
success boolean
output string
command string
env object
filter string
error string

Examples

List all processes

// Input
{
  "operation": "list"
}

// Output
{
  "ok": true,
  "count": 120,
  "processes": [
    {
      "name": "notepad.exe",
      "pid": 1234,
      "memory_kb": 8192
    }
  ]
}

Run a command and capture output

// Input
{
  "operation": "run",
  "command": "ipconfig /all"
}

// Output
{
  "ok": true,
  "command": "ipconfig /all",
  "output": "Windows IP Configuration..."
}

Start a process fire-and-forget

// Input
{
  "operation": "start",
  "command": "notepad.exe"
}

// Output
{
  "ok": true,
  "pid": 5678
}

Install & Discovery

Install

ppm install mcp-process

Get JSON Schema

GET /v1/packages/mcp-process/1.0.0/schema

Discover by keyword

GET /v1/mcp/discover?q=process
Discovery hint: Install with ppm install mcp-process or invoke remotely via POST /v1/invoke/mcp-process on the MCP Service.

PascalAI Usage

uses toolslib;
var Tool := LoadTool('mcp-process');
var R := Tool.Call(JsonObj(['operation','run','command','dir C:\']));
Writeln(R['output']);