MCP Git Repo Browser Server

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

javascript

3

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You get a lightweight MCP server that lets you interact with Git repositories through simple MCP endpoints. It can generate a tree-like view of a repository and fetch contents of specific files, making it easy to explore code bases without leaving your MCP ecosystem.

How to use

Connect to the MCP client and start exploring a repository. You can request a directory structure for a given repository URL to get an ASCII representation of its layout, or request specific files to retrieve their contents. These tools help you quickly understand project organization and inspect important files without manually cloning repositories.

Practical capabilities you can perform include:

How to install

Prerequisites you need before running the server:

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

Then follow these steps to set up and run the server locally.

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

# Start the server (stdio):
node src/index.js

Configuration

Configure your MCP settings to run the server locally. The following snippet shows how to declare the MCP server so clients can connect via stdio using Node.js to execute the main script.

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

Available tools

git_directory_structure

Returns a tree-like ASCII representation of a repository's directory structure. Input is a repository URL; output is a readable directory tree.

git_read_important_files

Reads and returns the contents of specified files within a repository. Input includes the repository URL and a list of file paths; output maps each path to its file contents.