Git Repository Browser

🚀 MCP Git Repository Browser (Node.js)

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

🚀 Quick Start

After installation, run the following command in the terminal to view all available commands and options:

git-commands-mcp --help

✨ Features

This server offers the following tools:

Basic Repository Operations

1. git_directory_structure: Returns a tree-like representation of the repository's directory structure.

   • Input: Repository URL
   • Output: ASCII tree representation of the repository structure

2. git_read_files: Reads and returns the contents of specified files.

   • Input: Repository URL and a list of file paths
   • Output: A dictionary mapping file paths to their contents

3. git_search_code: Searches in the repository code.

   • Input: Repository URL, search term, and optional parameters (e.g., size limit)
   • Output: A list of contents of matching files

Project Structure

- src/
  - index.js: Entry point
  - utils/
    - gitOperations.js: Git operation tools
  - config/
    - settings.json: Default configuration

📦 Installation

Via npm (Recommended)

npm install -g git-commands-mcp

Manual Installation

git clone https://github.com/bsreeram08/git-commands-mcp.git
cd git-commands-mcp
npm install

📚 Documentation

Add the following content to your MCP settings configuration file:

{
  "mcpServers": {
    "git-commands-mcp": {
      "command": "git-commands-mcp"
    }
  }
}

For manual installation, use:

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

🔧 Technical Details

• Built with Node.js to provide efficient repository operations.
• Supports multi-platform compatibility.
• Offers detailed error handling and logging.

Requirements

• Node.js v14 or higher
• Git 2.0 or higher
• npm v6 or higher

📄 License

This project is under the MIT License. Please refer to the LICENSE file for details.

Links

• GitHub Repository
• NPM Package
• Report Issues