MCP Start App
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
MCP Start App
A comprehensive Model Context Protocol (MCP) server for advanced local file management and system operations.
Features
ποΈ File 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
βοΈ Advanced File Editing
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
π Advanced Search Capabilities
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
π» System Operations
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
π§ Code Tools
Syntax Validation: Check syntax for Python, JavaScript, JSON, etc.
Code Formatting: Format code using standard formatters (Black, Prettier)
Language Detection: Auto-detect programming languages
π Backup & History
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
π‘οΈ Security & Safety
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
Related MCP server: AI FileSystem MCP
Quick Start
1. Installation
# 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.sh2. Activation
# Activate the virtual environment
source venv/bin/activate
# Run the server
mcp-start-app3. Alternative Run Methods
# Using the run script (auto-activates venv)
./scripts/run_server.py
# Direct Python execution
source venv/bin/activate
python -m mcp_start_app.mainConfiguration
Claude Desktop Configuration
Add to your Claude Desktop config file:
{
"mcpServers": {
"mcp-start-app": {
"command": "/Users/{{USERNAME}}/Documents/mcp-start-app/scripts/run_server.py",
"args": []
}
}
}Available Tools
Basic File Operations
list_files(directory, show_hidden)- List directory contentsread_file(file_path)- Read text file contentswrite_file(file_path, content)- Write content to fileget_file_lines(file_path, start_line, end_line)- Get specific linesget_file_info(file_path)- Get detailed file information
Advanced File Editing
edit_file_lines(file_path, start_line, new_content, end_line)- Edit specific linesinsert_lines(file_path, line_number, content)- Insert new linesdelete_lines(file_path, start_line, end_line)- Delete linesreplace_in_file(file_path, search_pattern, replace_with, use_regex)- Find & replaceget_file_diff(file_path, backup_file)- Show file differencesget_edit_history(limit, file_path)- View edit history
Advanced Search Tools
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 searchreplace_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 replacesearch_files_by_name(filename_pattern, search_path, case_sensitive, exact_match, show_hidden, exclude_patterns)- Search files by namesearch_in_files(search_pattern, directory, file_pattern, use_regex)- Simple text searchget_search_stats(search_path)- Get directory statistics
System Tools
run_command(command)- Execute system commands (with safety restrictions)get_system_info()- Get comprehensive system informationfind_files(pattern, directory, max_results)- Find files by patternget_running_processes()- View running processes
Code Tools
validate_syntax(file_path)- Check code syntaxformat_code(file_path, language)- Format code files
Data Tools
get_local_data(query)- Local data queries
Project Structure
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 fileDevelopment
Running Tests
source venv/bin/activate
pytest # Run all tests
pytest --cov # Run with coverageCode Quality
source venv/bin/activate
black src/ tests/ # Format code
isort src/ tests/ # Sort imports
flake8 src/ tests/ # Lint code
mypy src/ # Type checkingLicense
This project is licensed under the MIT License.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Work on your own computers from Claude or ChatGPT: run commands, edit and search files.
Securely search and manage workspace context files for AI agents and teams.
A real-time, multiplayer filesystem for agents and humans: shared files, live edits, history.
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables secure local filesystem operations and interactive terminal sessions for AI assistants. Provides 12 tools for file management, directory operations, code searching, and running interactive REPLs with security protections.34 npmMIT
- AlicenseAqualityDmaintenanceProvides intelligent file system operations with advanced features including code analysis and modification across multiple languages, version control (Git/GitHub), file compression, encryption, semantic search, batch operations, and secure shell command execution.15MIT
- AlicenseAqualityCmaintenanceA comprehensive MCP server that enables AI models to perform local file operations, command execution, and task management across multiple platforms. It features advanced capabilities like row-level file editing, directory searching, and system monitoring with built-in security filters.1348 npmMulan Permissive Software , Version 2
- FlicenseNot gradedqualityDmaintenanceA local, customizable MCP server for filesystem access that extends the official Anthropic implementation with additional tools and functionality. It enables users to securely read, write, edit, and manage files and directories within specific allowed local paths.-