Android Filesystem

Navegue e leia arquivos com segurança dentro de um projeto Android, com validação integrada e controles de acesso para diretórios sensíveis.

Documentação

Configuração do Servidor MCP

License Python Version

Visão Geral

Este projeto fornece um servidor MCP para Claude que permite acesso seguro aos arquivos de projetos Android. Ele permite que assistentes de IA naveguem e leiam código-fonte de projetos Android, verificando arquivos essenciais de configuração do Gradle que validam projetos Android autênticos.

Principais recursos:

  • Validação de Projeto: Garante que os diretórios sejam projetos Android válidos, verificando arquivos do Gradle
  • Navegação de Arquivos: Lista todos os arquivos Kotlin, KTS, TOML e AndroidManifest.xml agrupados por diretório
  • Leitura de Arquivos: Fornece acesso seguro para ler arquivos individuais ou múltiplos com filtragem adequada
  • Segurança: Impede o acesso a diretórios sensíveis como .gradle, .git e pastas de build

Esta ferramenta é ideal para desenvolvedores que desejam aproveitar o Claude para ajudar a entender, analisar e trabalhar com bases de código Android.

Configuração do Servidor

Adicione esta configuração às configurações MCP do seu cliente Claude:

{
  "mcpServers": {
    "Android source code": {
      "command": "/path/to/uv", 
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "./filesystem_android/main.py"
      ]
    }
  }
}

Observação: Substitua /path/to/uv pelo caminho real da sua instalação UV

Instalação

# Install UV if missing
curl -LsSf https://astral.sh/uv/install.sh | sh

# Initialize project
uv venv
uv pip install -r uv.lock

Licença

Licença MIT - Consulte LICENSE para detalhes