MCP Start App

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

- Read/Write Files: Full support for text file operations with encoding handling
- List Directories: Browse filesystem with size information and hidden file support
- File Information: Detailed metadata including permissions, timestamps, and size
- Path Validation: Robust path handling with security checks

- Line-based Editing: Edit, insert, or delete specific lines in files
- Find & Replace: Text replacement with regex support across multiple files
- Diff Viewing: Compare current files with backups
- Edit History: Track all file modifications with detailed logs

- VSCode-like Search: Advanced search across multiple files with context
- File Type Filtering: Search by extension groups (code, web, config, etc.)
- Pattern Matching: Support for wildcards and regex
- Context Display: Show surrounding lines for search results
- File Name Search: Find files by name patterns
- Search Statistics: Analyze file distribution and sizes

- Command Execution: Safe execution of system commands
- System Information: Hardware and software details
- Process Management: View running processes
- File Finding: Advanced file discovery with patterns

- Syntax Validation: Check syntax for Python, JavaScript, JSON, etc.
- Code Formatting: Format code using standard formatters (Black, Prettier)
- Language Detection: Auto-detect programming languages

- Automatic Backups: Files are backed up before modifications
- Edit Tracking: Complete history of all file operations
- Restoration: Easy restore from backups
- History Analysis: Statistics and insights on editing patterns

- Path Validation: Prevents directory traversal attacks
- File Size Limits: Configurable limits to prevent memory issues
- Command Filtering: Restricted dangerous command execution
- Backup System: Automatic backup before destructive operations

# Clone or navigate to the project cd /Users/{{USERNAME}}/Documents/mcp-start-app # Run the installation script (sets up venv and installs everything) ./scripts/install.sh

# Activate the virtual environment source venv/bin/activate # Run the server mcp-start-app

# Using the run script (auto-activates venv) ./scripts/run_server.py # Direct Python execution source venv/bin/activate python -m mcp_start_app.main

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

- list_files(directory, show_hidden)- List directory contents
- read_file(file_path)- Read text file contents
- write_file(file_path, content)- Write content to file
- get_file_lines(file_path, start_line, end_line)- Get specific lines
- get_file_info(file_path)- Get detailed file information

- edit_file_lines(file_path, start_line, new_content, end_line)- Edit specific lines
- insert_lines(file_path, line_number, content)- Insert new lines
- delete_lines(file_path, start_line, end_line)- Delete lines
- replace_in_file(file_path, search_pattern, replace_with, use_regex)- Find & replace
- get_file_diff(file_path, backup_file)- Show file differences
- get_edit_history(limit, file_path)- View edit history

- search_adv(search_term, search_path, case_sensitive, whole_word, use_regex, include_patterns, exclude_patterns, file_types, max_results, context_lines, show_hidden)- Advanced multi-file search
- replace_adv(search_term, replace_with, search_path, case_sensitive, whole_word, use_regex, include_patterns, exclude_patterns, file_types, dry_run, backup)- Advanced multi-file replace
- search_files_by_name(filename_pattern, search_path, case_sensitive, exact_match, show_hidden, exclude_patterns)- Search files by name
- search_in_files(search_pattern, directory, file_pattern, use_regex)- Simple text search
- get_search_stats(search_path)- Get directory statistics

- run_command(command)- Execute system commands (with safety restrictions)
- get_system_info()- Get comprehensive system information
- find_files(pattern, directory, max_results)- Find files by pattern
- get_running_processes()- View running processes

- validate_syntax(file_path)- Check code syntax
- format_code(file_path, language)- Format code files

- get_local_data(query)- Local data queries

mcp-start-app/ ├── 📁 venv/ # Virtual environment ├── 📁 src/mcp_local/ # Main package │ ├── 📁 core/ # Core utilities & config │ ├── 📁 services/ # Business logic layer │ ├── 📁 tools/ # MCP tool implementations │ │ ├── file_operations.py # Basic file tools │ │ ├── file_editing.py # Advanced editing tools │ │ ├── search_tools.py # Search and replace tools │ │ ├── system_tools.py # System operation tools │ │ └── code_tools.py # Code formatting and validation │ ├── main.py # Entry point │ └── server.py # Server configuration ├── 📁 tests/ # Test suite ├── 📁 scripts/ # Installation & run scripts ├── requirements.txt # Dependencies ├── pyproject.toml # Python packaging └── README.md # This file

source venv/bin/activate pytest # Run all tests pytest --cov # Run with coverage

source venv/bin/activate black src/ tests/ # Format code isort src/ tests/ # Sort imports flake8 src/ tests/ # Lint code mypy src/ # Type checking

This project is licensed under the MIT License.

Visualize directory structures with real-time updates, configurable depth, and smart exclusions for efficient project navigation.

A server for programmatic exploration of local files and folders.

Provides essential utility tools for text processing, file operations, and system tasks.

Provides utility functions for common tasks like text processing, encoding, decoding, hashing, and system information.

Cross-platform MCP server for system clipboard access. Three tools: get_clipboard, set_clipboard, watch_clipboard. Single Rust binary, zero runtime deps.

🧿 One MCP for developers - No tool tax, no context rot. 100+ tools including Brave, Gemini, Context7, Version Checker, Excel, File Ops, Database, Chrome DevTools.

A local server that allows AI to execute Windows CMD commands, read/write files, and manage directories within a specified path.

Securely browse and read files within an Android project, with built-in validation and access controls for sensitive directories.

An MCP server for viewing, editing, and creating text files, based on the Claude built-in text editor tool.

A cross-platform filesystem server for Linux, macOS, and Windows with secure path restrictions.