py-commander-mcp

MCP Server for filesystem operations, process execution, PDF creation, system management, and configuration — all via uvx, no Node.js required.

Built as a Python port of Desktop Commander's key features.

Features

Filesystem

• Read files: text (pagination), PDF, Excel, DOCX, images (base64)
• Write files: text, DOCX (markdown→styled), Excel (JSON→sheets)
• PDF creation: create from markdown, insert/delete pages, page breaks
• Edit files: surgical edit_block find/replace
• Directory ops: list (recursive depth), create, move/rename
• Search: by file name (glob/regex) or file content with context

Process execution

• Start shell commands, REPLs (Python, Node.js, etc.), scripts
• Interactive stdin I/O with prompt detection
• Output pagination (offset/length like read_file)
• Session management: list, force-terminate, auto-cleanup

System tools

• list_processes: cross-platform (Linux/macOS/Windows) process listing
• kill_process: kill any system PID (SIGTERM → SIGKILL on Unix, taskkill on Windows)
• get_config / set_config_value: JSON-based config persistence (blocked commands, allowed directories, limits, telemetry)

Usage

{
  "mcpServers": {
    "py-commander-mcp": {
      "command": "uvx",
      "args": ["py-commander-mcp"]
    }
  }
}

Tools

Filesystem (12 tools)

Process execution (5 tools)

System tools (4 tools)