MCP Git Repo Browser (Node.js)

A Node.js implementation of a Git repository browser using the Model Context Protocol (MCP).

Configuration

Add this to your MCP settings configuration file:

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

Features

The server provides two main tools:

git_directory_structure: Returns a tree-like representation of a repository's directory structure
- Input: Repository URL
- Output: ASCII tree representation of the repository structure
git_read_important_files: Reads and returns the contents of specified files in a repository
- Input: Repository URL and list of file paths
- Output: Dictionary mapping file paths to their contents

Implementation Details

Uses Node.js native modules (crypto, path, os) for core functionality
Leverages fs-extra for enhanced file operations
Uses simple-git for Git repository operations
Implements clean error handling and resource cleanup
Creates deterministic temporary directories based on repository URL hashes
Reuses cloned repositories when possible for efficiency

Requirements

Node.js 14.x or higher
Git installed on the system

Installation

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

Usage

Start the server:

node src/index.js

The server runs on stdio, making it compatible with MCP clients.

License

MIT License - see the LICENSE file for details.