home / mcp / git terminal mcp server

Git Terminal MCP Server

Provides MCP endpoints to execute terminal commands, clone repositories, and create modern web projects from a remote client.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "abdurraahimm-mcp-git-terminal-server": {
      "command": "node",
      "args": [
        "/path/to/mcp-git-terminal/dist/index.js"
      ]
    }
  }
}

You run a compact MCP server that exposes terminal capabilities and Git utilities to a remote client. With this server, you can execute commands, clone repositories, scaffold frontend projects, and open results in VSCode from anywhere you have MCP access. It’s designed to empower automation and remote development workflows by combining terminal access with project scaffolding in a single, reusable endpoint.

How to use

Connect to the MCP server using your MCP client and select the git_terminal endpoint. You can request actions such as executing shell commands in a specific directory, cloning Git repositories, and creating new React, Vue, or Next.js projects. You can also open directories or files in VSCode and verify directory existence and contents. Each action is performed by calling the corresponding tool with the required parameters.

How to install

Prerequisites you need before installation: Node.js (which includes npm) and Visual Studio Code if you plan to open projects in VSCode.

1. Clone the server repository to your machine.

2. Install dependencies.

3. Build the server.

4. Start the server and confirm it is ready to accept MCP requests.

Notes and configuration

This MCP server provides a stdio endpoint that runs locally. The runtime command and path to the built index file are shown in the configuration example you should load into your MCP client. The server relies on Node to run the built JavaScript file.

Security and usage tips

Limit access to the MCP endpoint to trusted clients. If you expose the endpoint over a network, implement appropriate authentication and network controls. When opening projects in VSCode, ensure you have a secure development environment and avoid exposing local file paths to unauthorized users.

Troubleshooting

If the server fails to start, verify you are using the correct runtime command and path to the built index file. Check that Node is installed and that the build step completed successfully. Review any error messages from the MCP client for hints on missing parameters or permissions.

Example MCP client configuration

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

Available tools

execute_command

Run a terminal command in a specified working directory, enabling remote automation of build, test, or management tasks.

git_clone

Clone a Git repository to a designated destination path with an option to open the clone in VSCode.

install_react_project

Create a new React project using Vite, with optional auto-install of dependencies and opening in VSCode.

install_vue_project

Create a new Vue project using Vite, with optional auto-install of dependencies and opening in VSCode.

install_next_project

Create a new Next.js project, with options for TypeScript and automatic dependency installation.

open_in_vscode

Open a directory or file in Visual Studio Code from the server.

check_directory

Verify existence of a directory and list its contents to confirm structure before performing actions.