Git Command MCP Server

by ukiuni

296 downloads
Not rated
GitHub

About

It is an MCP server that provides tools for executing various Git commands. It requires a local installation of Git (git or git.exe) and is designed for use with MCP clients like Roo Code or Claude Desktop.

Details

Author
ukiuni
Downloads
296
Categories
Developer Tools

- Executes Git commands through the Model Context Protocol.
- Tools follow a consistent git- naming convention.
- Returns STDOUT, STDERR, and server-side error messages.
- Requires Git installed locally on the system.
- Supports popular MCP clients like GitHub Copilot and Cursor.
- Open source under the MIT License.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Git Command MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install via npm i mcp-git or clone the repository, then run npm install. Configure your MCP client with the command node and an argument pointing to the absolute path of dist/index.js. Tools are invoked using a git- prefix (e.g., git-status, git-commit).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "git command mcp server": {
            "mpc-git": {
                "command": "node",
                "args": [
                    "/path_to_mcp-git/mcp-git/dist/index.js"
                ]
            }
        }
    }
}

McpServers

{
    "mpc-git": {
        "command": "node",
        "args": [
            "/path_to_mcp-git/mcp-git/dist/index.js"
        ]
    }
}

Git Command MCP Server

This is a Model Context Protocol (MCP) server that provides tools for executing various Git commands.

It requires that the git (git.exe) command is installed locally.

Since a large part of this was created using generative AI, please contact http://github.com/ukiuni/mcp-git if you notice anything.

Setup

Clone from GitHub

1. (If you haven't already) Clone the repository:
    git clone http://github.com/ukiuni/mcp-git.git
    cd mcp-git
    
2. Install dependencies: Make sure you have Node.js and npm installed. Then run:
    npm install
    

Install with npm

1. Install with npm.
   npm i mcp-git
   
It will be installed in node_modules, so please set the path to the relevant location in the next section.

Connecting from an MCP Client

When connecting from an MCP client (such as Roo Code, GitHub Copilot, Claude Desktop, Cursor, etc.), please use the following settings.

{
  "mcpServers": {
    "mpc-git": {
      "command": "node",
      "args": [
        "/path_to_mcp-git/mcp-git/dist/index.js"
      ]
    }
  }
}

Please set path_to_mcp to the absolute path to the directory where you cloned git.

Available Tools

Each tool name follows the format git- prefix followed by the command name (e.g., git-add, git-commit, git-status).

Tool Output

The execution result of the tool is returned as text content, usually including:

STDOUT: Standard output from the Git command.
STDERR: Standard error output from the Git command (Note: In Git, stderr does not necessarily indicate an error).

  • ERROR: Execution errors that occurred within the server itself.


If the command succeeds without output, a message indicating success will be provided.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Trademarks

Trademarks mentioned in this project are trademarks of their respective companies.
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.