MCP Git Repo Browser
local-only server
The server can only run on the client’s local machine because it depends on local resources.
Integrations
Provides tools to browse Git repositories, including retrieving directory structures as ASCII trees and reading specified file contents from repositories accessed via URL.
Implements Git repository browsing functionality in Node.js, allowing for efficient cloning and exploration of repositories through a standardized interface.
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:
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
Usage
Start the server:
The server runs on stdio, making it compatible with MCP clients.
License
MIT License - see the LICENSE file for details.
You must be authenticated.
A Node.js server that allows browsing Git repositories through MCP, providing tools to view directory structures and read important files from repositories.