py-commander-mcp 0.1.0

MCP Server for filesystem operations — read, write, edit, search, manage files and directories

py-commander-mcp

MCP Server for filesystem operations — read, write, edit, search, and manage files and directories.

Built as a Python port of the key features from Desktop Commander.

Features

• Read files: text (with offset/length pagination), PDF, Excel, DOCX, images (base64)
• Write files: text, DOCX (from markdown), Excel (from JSON 2D arrays)
• Edit files: surgical find/replace with edit_block
• Directory ops: list (recursive with depth), create, move/rename
• File metadata: size, dates, line counts
• Search: by file name (glob/regex) or file content with context lines

Usage

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

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
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	Stop and free a search session
list_searches	List active searches