Skip to main content

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)

Tool Description
read_file Read files (text, PDF, Excel, DOCX, images)
read_multiple_files Read multiple files at once
write_file Write/create/append files
edit_block Surgical find/replace edits
write_pdf Create/modify PDFs from markdown
create_directory Create directories
list_directory List directory contents with depth
move_file Move/rename files and directories
get_file_info File metadata
start_search Search files by name or content
get_more_search_results Paginate search results
stop_search / list_searches Manage search sessions

Process execution (5 tools)

Tool Description
start_process Start a subprocess (REPL, script, command)
read_process_output Read output with offset/length pagination
interact_with_process Send stdin, capture response, detect prompts
force_terminate Kill a managed process (SIGTERM → SIGKILL)
list_sessions List active managed process sessions

System tools (4 tools)

Tool Description
list_processes List all running system processes (cross-platform)
kill_process Kill any system process by PID
get_config Return full server configuration
set_config_value Set a configuration value by key

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

py_commander_mcp-0.3.0.tar.gz (19.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

py_commander_mcp-0.3.0-py3-none-any.whl (22.5 kB view details)

Uploaded Python 3

File details

Details for the file py_commander_mcp-0.3.0.tar.gz.

File metadata

  • Download URL: py_commander_mcp-0.3.0.tar.gz
  • Upload date:
  • Size: 19.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"44","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for py_commander_mcp-0.3.0.tar.gz
Algorithm Hash digest
SHA256 4de472b72512dcd4edc6b7aaa4078a88721c156258d95bb433992e0dbcf83bba
MD5 94ae5a270d6a4792d0bc1a719dc87739
BLAKE2b-256 58f1c77d17c6f73c390bc193b98a64aaae35a1cc44fcc4f18792043813198dbe

See more details on using hashes here.

File details

Details for the file py_commander_mcp-0.3.0-py3-none-any.whl.

File metadata

  • Download URL: py_commander_mcp-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 22.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.12.1 {"installer":{"name":"uv","version":"0.12.1","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Fedora Linux","version":"44","id":"","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for py_commander_mcp-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 d264ccba445847e2bfa1bd2bacbfdc482f67d59ed285a7beb4fa9069ed836b44
MD5 7bf3c351d92514aeee4296ae1d0386ed
BLAKE2b-256 54472e9c0cf8afadd3ef0f62563120cc0c8aef643c8b968931b2ec8a58a3a4a2

See more details on using hashes here.

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 files

0.2.1

2 files

0.2.0

2 files

0.1.1

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page