proc-mcp

proc-mcp is a stdio [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server written in Go. It exposes read-only, structured access to process inspection on Unix-like systems, primarily by wrapping ps and optionally pstree when present.

Repository: github.com/ipolyzos/proc-mcp

• Safe, predictable, read-only process data for agents and tools.
• Normalized behavior across Linux and macOS where practical, with explicit documentation where it is not.
• Small, versionable MCP tool surface that grows incrementally.

The server does not terminate processes, send signals, change niceness, trace, inject code, or perform any other mutating operation.

The server speaks MCP over stdio and registers twelve read-only tools on Linux and macOS: process listing (with optional limit and `sort_by` ordering), PID lookup, details, children, name search, per-user lists, usage summaries, top-N by CPU/memory, pstree text plus availability probe, command-line inspection, and grouping fields (pgid / sid / tty). Authoritative schemas and limits: [docs/client-contract.md](docs/client-contract.md).

| Doc | Purpose | | --- | -------- | | docs/README.md | Index of all guides | | docs/client-contract.md | Tool inputs/outputs (stability contract) | | docs/using.md | MCP client configuration | | docs/contributing.md | Branch workflow and PR process | | docs/releases.md | Versioning and main releases | | CHANGELOG.md | Release history | | SECURITY.md | Security policy (GitHub Security tab) |

• Go 1.25 or newer, with the toolchain pinned in go.mod (currently 1.25.8 for security fixes). Use a recent patch release when developing.
• Runtime: Linux or