MCP Start App

Um servidor MCP para gerenciamento de arquivos locais e operações do sistema.

GitHub
1
Experimente este MCPPatrocinado

Documentação

MCP Start App

Um servidor abrangente de Model Context Protocol (MCP) para gerenciamento avançado de arquivos locais e operações de sistema.

Recursos

🗂️ Operações de Arquivo

  • Ler/Escrever Arquivos: Suporte completo para operações de arquivos de texto com tratamento de codificação
  • Listar Diretórios: Navegue pelo sistema de arquivos com informações de tamanho e suporte a arquivos ocultos
  • Informações de Arquivo: Metadados detalhados, incluindo permissões, timestamps e tamanho
  • Validação de Caminho: Tratamento robusto de caminhos com verificações de segurança

✏️ Edição Avançada de Arquivos

  • Edição Baseada em Linhas: Edite, insira ou exclua linhas específicas em arquivos
  • Localizar e Substituir: Substituição de texto com suporte a regex em vários arquivos
  • Visualização de Diff: Compare arquivos atuais com backups
  • Histórico de Edições: Rastreie todas as modificações de arquivos com logs detalhados

🔍 Capacidades Avançadas de Pesquisa

  • Pesquisa estilo VSCode: Pesquisa avançada em vários arquivos com contexto
  • Filtragem por Tipo de Arquivo: Pesquise por grupos de extensão (código, web, config, etc.)
  • Correspondência de Padrões: Suporte a curingas e regex
  • Exibição de Contexto: Mostre linhas ao redor dos resultados da pesquisa
  • Pesquisa por Nome de Arquivo: Encontre arquivos por padrões de nome
  • Estatísticas de Pesquisa: Analise distribuição e tamanhos de arquivos

💻 Operações de Sistema

  • Execução de Comandos: Execução segura de comandos do sistema
  • Informações do Sistema: Detalhes de hardware e software
  • Gerenciamento de Processos: Visualize processos em execução
  • Localização de Arquivos: Descoberta avançada de arquivos com padrões

🔧 Ferramentas de Código

  • Validação de Sintaxe: Verifique sintaxe para Python, JavaScript, JSON, etc.
  • Formatação de Código: Formate código usando formatadores padrão (Black, Prettier)
  • Detecção de Linguagem: Detecte automaticamente linguagens de programação

🔄 Backup e Histórico

  • Backups Automáticos: Arquivos são copiados antes de modificações
  • Rastreamento de Edições: Histórico completo de todas as operações de arquivo
  • Restauração: Restaure facilmente a partir de backups
  • Análise de Histórico: Estatísticas e insights sobre padrões de edição

🛡️ Segurança e Proteção

  • Validação de Caminho: Previne ataques de travessia de diretório
  • Limites de Tamanho de Arquivo: Limites configuráveis para evitar problemas de memória
  • Filtragem de Comandos: Restrição de execução de comandos perigosos
  • Sistema de Backup: Backup automático antes de operações destrutivas

Início Rápido

1. Instalação

# 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

2. Ativação

# Activate the virtual environment
source venv/bin/activate

# Run the server
mcp-start-app

3. Métodos Alternativos de Execução

# Using the run script (auto-activates venv)
./scripts/run_server.py

# Direct Python execution
source venv/bin/activate
python -m mcp_start_app.main

Configuração

Configuração do Claude Desktop

Adicione ao seu arquivo de configuração do Claude Desktop:

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

Ferramentas Disponíveis

Operações Básicas de Arquivo

  • list_files(directory, show_hidden) - Listar conteúdo do diretório
  • read_file(file_path) - Ler conteúdo de arquivo de texto
  • write_file(file_path, content) - Escrever conteúdo em arquivo
  • get_file_lines(file_path, start_line, end_line) - Obter linhas específicas
  • get_file_info(file_path) - Obter informações detalhadas do arquivo

Edição Avançada de Arquivos

  • edit_file_lines(file_path, start_line, new_content, end_line) - Editar linhas específicas
  • insert_lines(file_path, line_number, content) - Inserir novas linhas
  • delete_lines(file_path, start_line, end_line) - Excluir linhas
  • replace_in_file(file_path, search_pattern, replace_with, use_regex) - Localizar e substituir
  • get_file_diff(file_path, backup_file) - Mostrar diferenças de arquivo
  • get_edit_history(limit, file_path) - Visualizar histórico de edições

Ferramentas Avançadas de Pesquisa

  • search_adv(search_term, search_path, case_sensitive, whole_word, use_regex, include_patterns, exclude_patterns, file_types, max_results, context_lines, show_hidden) - Pesquisa avançada em vários arquivos
  • replace_adv(search_term, replace_with, search_path, case_sensitive, whole_word, use_regex, include_patterns, exclude_patterns, file_types, dry_run, backup) - Substituição avançada em vários arquivos
  • search_files_by_name(filename_pattern, search_path, case_sensitive, exact_match, show_hidden, exclude_patterns) - Pesquisar arquivos por nome
  • search_in_files(search_pattern, directory, file_pattern, use_regex) - Pesquisa de texto simples
  • get_search_stats(search_path) - Obter estatísticas do diretório

Ferramentas de Sistema

  • run_command(command) - Executar comandos do sistema (com restrições de segurança)
  • get_system_info() - Obter informações abrangentes do sistema
  • find_files(pattern, directory, max_results) - Encontrar arquivos por padrão
  • get_running_processes() - Visualizar processos em execução

Ferramentas de Código

  • validate_syntax(file_path) - Verificar sintaxe de código
  • format_code(file_path, language) - Formatar arquivos de código

Ferramentas de Dados

  • get_local_data(query) - Consultas de dados locais

Estrutura do Projeto

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

Desenvolvimento

Executando Testes

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

Qualidade de Código

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

Licença

Este projeto é licenciado sob a Licença MIT.