mcp-terminal
MCP server for git and terminal access
Features
This MCP server provides the following tools:
execute_command: Execute a terminal command in a specified directory.git_clone: Clone a git repository to a specified location.install_react_project: Create a new React project using Vite.install_vue_project: Create a new Vue project using Vite.install_next_project: Create a new Next.js project.open_in_vscode: Open a directory or file in VSCode.check_directory: Check if a directory exists and list its contents.
Prerequisites
- Node.js (which includes npm)
- Visual Studio Code (for features that open projects in VSCode)
Installation
- Clone the repository (if you haven't already):
git clone https://github.com/AbdurRaahimm/mcp-git-terminal-server.git mcp-terminal cd mcp-terminal - Install dependencies:
npm install
Usage
-
Build the server:
npm run build -
Start the server:
npm run startAlternatively, you can use the development script which builds and then starts the server:
npm run devThe server will then be running on stdio, ready to accept MCP requests from a compatible client.
To configure this server with an MCP client, you might need to specify the path to the built
index.jsfile (e.g.,dist/index.jsin this project's root) and the command to run it (e.g.,node). Refer to your MCP client's documentation for specific instructions.
Available Tools
Here's a more detailed look at the available tools and their parameters:
execute_command
Execute a terminal command in a specified directory.
- Input Schema:
command(string, required): The command to execute (e.g., 'npm install', 'ls -la').cwd(string, optional): Working directory for the command (defaults to current directory).
git_clone
Clone a git repository to a specified location.
- Input Schema:
repositoryUrl(string, required): Git repository URL.destination(string, required): Destination path where to clone the repository.openInVSCode(boolean, optional): Open the cloned repository in VSCode (default:false).
install_react_project
Create a new React project using Vite and open it in VSCode.
- Input Schema:
projectName(string, required): Name of the React project.destination(string, required): Directory where to create the project (e.g.,~/Desktop).template(string, optional, enum:["react", "react-ts", "react-swc", "react-swc-ts"]): Vite template to use (default:react-ts).installDependencies(boolean, optional): Install dependencies after creating project (default:true).
install_vue_project
Create a new Vue project using Vite and open it in VSCode.
- Input Schema:
projectName(string, required): Name of the Vue project.destination(string, required): Directory where to create the project (e.g.,~/Desktop).template(string, optional, enum:["vue", "vue-ts"]): Vite template to use (default:vue-ts).installDependencies(boolean, optional): Install dependencies after creating project (default:true).
install_next_project
Create a new Next.js project and open it in VSCode.
- Input Schema:
projectName(string, required): Name of the Next.js project.destination(string, required): Directory where to create the project (e.g.,~/Desktop).typescript(boolean, optional): Use TypeScript (default:true).installDependencies(boolean, optional): Install dependencies after creating project (default:true).
open_in_vscode
Open a directory or file in VSCode.
- Input Schema:
path(string, required): Path to open in VSCode.
check_directory
Check if a directory exists and list its contents.
- Input Schema:
path(string, required): Directory path to check.
License
This project is licensed under the MIT License. (As specified in package.json)
Usage
{
"mcpServers": {
"git-terminal": {
"command": "node",
"args": ["/path/to/mcp-git-terminal/dist/index.js"]
}
}
}