# portview MCP server

> Lists listening ports with their processes, lets an AI client inspect, diagnose, diff, and terminate port-owning processes across OSes.

- Repository: https://github.com/Mapika/portview
- Page: https://hostedmcp.org/servers/mapika/portview
- Transport: stdio
- Stars: 61
- License: MIT
- Latest version: 2.1.0

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `PORTVIEW_COLORS` | no | no |  |

## FAQ

### What does the portview MCP server let an AI agent do?

It exposes tools to list listening ports, inspect a port's processes and working directories, search by process name, run diagnostics, diff port changes, and kill the process on a port.

### How do I add portview to Claude Code as an MCP server?

Register it with the claude mcp add command, since the MCP server is bundled in the portview binary.

### Can I disable the kill_port tool for safety?

Yes, run the MCP server with --read-only to remove the destructive kill_port tool.

### Does portview require authentication for its MCP server?

No, the MCP server runs locally over stdio using newline-delimited JSON-RPC, with no authentication step.

### Which operating systems does the MCP server support?

The same platforms portview supports: Linux, macOS, and Windows, using native OS interfaces for port and process data.
