mcp-local MCP Server

A comprehensive Model Context Protocol (MCP) server for advanced local file management and system operations.

Local serverstdio

What is the mcp-local MCP Server?

mcp-local is an MCP project maintained in the nexus-aissam/mcp-local repository. The maintainer describes its purpose as “A comprehensive Model Context Protocol (MCP) server for advanced local file management and system operations”. Read the project documentation for the complete scope.

Local setup

The project provides a local client configuration using /Users/{{USERNAME}}/Documents/mcp-start-app/scripts/run_server.py. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_filesdirectory, show_hidden) - List directory contents
read_filefile_path) - Read text file contents
write_filefile_path, content) - Write content to file
get_file_linesfile_path, start_line, end_line) - Get specific lines
get_file_infofile_path) - Get detailed file information
edit_file_linesfile_path, start_line, new_content, end_line) - Edit specific lines
insert_linesfile_path, line_number, content) - Insert new lines
delete_linesfile_path, start_line, end_line) - Delete lines
replace_in_filefile_path, search_pattern, replace_with, use_regex) - Find & replace
get_file_difffile_path, backup_file) - Show file differences
get_edit_historylimit, file_path) - View edit history
search_advsearch_term, search_path, case_sensitive, whole_word, use_regex, include_patterns, exclude_patterns, file_types, max_results, context_lines, show_hidden) -…
replace_advsearch_term, replace_with, search_path, case_sensitive, whole_word, use_regex, include_patterns, exclude_patterns, file_types, dry_run, backup) - Advanced…
search_files_by_namefilename_pattern, search_path, case_sensitive, exact_match, show_hidden, exclude_patterns) - Search files by name
search_in_filessearch_pattern, directory, file_pattern, use_regex) - Simple text search
get_search_statssearch_path) - Get directory statistics
run_commandcommand) - Execute system commands (with safety restrictions)
get_system_info) - Get comprehensive system information
find_filespattern, directory, max_results) - Find files by pattern
get_running_processes) - View running processes
validate_syntaxfile_path) - Check code syntax
format_codefile_path, language) - Format code files
get_local_dataquery) - Local data queries

How to install the mcp-local MCP Server

{
  "mcpServers": {
    "mcp-start-app": {
      "command": "/Users/{{USERNAME}}/Documents/mcp-start-app/scripts/run_server.py",
      "args": []
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.