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_blockfind/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 listingkill_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)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4de472b72512dcd4edc6b7aaa4078a88721c156258d95bb433992e0dbcf83bba
|
|
| MD5 |
94ae5a270d6a4792d0bc1a719dc87739
|
|
| BLAKE2b-256 |
58f1c77d17c6f73c390bc193b98a64aaae35a1cc44fcc4f18792043813198dbe
|
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d264ccba445847e2bfa1bd2bacbfdc482f67d59ed285a7beb4fa9069ed836b44
|
|
| MD5 |
7bf3c351d92514aeee4296ae1d0386ed
|
|
| BLAKE2b-256 |
54472e9c0cf8afadd3ef0f62563120cc0c8aef643c8b968931b2ec8a58a3a4a2
|