MCP Git Repo Browser

MCP Git Repo Browser (Node.js)

Uma implementação em Node.js de um navegador de repositórios Git usando o Model Context Protocol (MCP).

Configuração

Adicione isto ao seu arquivo de configuração de definições do MCP:

{
    "mcpServers": {
        "mcp-git-repo-browser": {
            "command": "node",
            "args": ["/path/to/mcp-git-repo-browser/src/index.js"]
        }
    }
}

Recursos

O servidor fornece duas ferramentas principais:

1. git_directory_structure: Retorna uma representação em forma de árvore da estrutura de diretórios de um repositório

   • Entrada: URL do repositório
   • Saída: Representação em árvore ASCII da estrutura do repositório

2. git_read_important_files: Lê e retorna o conteúdo de arquivos especificados em um repositório

   • Entrada: URL do repositório e lista de caminhos de arquivos
   • Saída: Dicionário mapeando caminhos de arquivos para seus conteúdos

Detalhes de Implementação

• Usa módulos nativos do Node.js (crypto, path, os) para funcionalidades principais
• Utiliza fs-extra para operações aprimoradas de arquivos
• Usa simple-git para operações de repositórios Git
• Implementa tratamento limpo de erros e limpeza de recursos
• Cria diretórios temporários determinísticos baseados em hashes de URLs de repositórios
• Reutiliza repositórios clonados quando possível para eficiência

Requisitos

• Node.js 14.x ou superior
• Git instalado no sistema

Instalação

git clone <repository-url>
cd mcp-git-repo-browser
npm install

Uso

Inicie o servidor:

node src/index.js

O servidor executa em stdio, tornando-o compatível com clientes MCP.

Licença

Licença MIT - consulte o arquivo LICENSE para detalhes.