Mcp Git Repo Browser
What is Mcp Git Repo Browser
mcp-git-repo-browser is a Node.js implementation of a Git repository browser that utilizes the Model Context Protocol (MCP) to provide structured access to Git repositories.
Use cases
Use cases include browsing repository structures, retrieving specific file contents for analysis, and integrating with other tools that utilize the MCP framework.
How to use
To use mcp-git-repo-browser, add the provided configuration to your MCP settings file, install the necessary dependencies, and start the server using the command ‘node src/index.js’.
Key features
Key features include the ability to return a tree-like representation of a repository’s directory structure and read the contents of specified important files within a repository.
Where to use
mcp-git-repo-browser can be used in software development environments, particularly for projects that require easy navigation and access to Git repositories.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Mcp Git Repo Browser
mcp-git-repo-browser is a Node.js implementation of a Git repository browser that utilizes the Model Context Protocol (MCP) to provide structured access to Git repositories.
Use cases
Use cases include browsing repository structures, retrieving specific file contents for analysis, and integrating with other tools that utilize the MCP framework.
How to use
To use mcp-git-repo-browser, add the provided configuration to your MCP settings file, install the necessary dependencies, and start the server using the command ‘node src/index.js’.
Key features
Key features include the ability to return a tree-like representation of a repository’s directory structure and read the contents of specified important files within a repository.
Where to use
mcp-git-repo-browser can be used in software development environments, particularly for projects that require easy navigation and access to Git repositories.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
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.
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
