Terminal Command Runner MCP Server
About
Terminal Command Runner MCP Server is a Model Control Protocol (MCP) server that provides terminal command execution and file system management capabilities for AI assistants through a RESTful API interface. It is designed for developers and AI agents that need to run commands…
Details
- Author
- neoforge-dev
- Downloads
- 242
- Categories
- Developer Tools
Jump to
- Execute commands with configurable timeouts
- Manage long-running background processes
- Command blacklisting for security
- Read, write, move, and search files
- Create directories and list contents
- Precise text editing with search and replace
- System information retrieval and math evaluation
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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Terminal Command Runner MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install Python 3.13+ and the uv package manager. Clone the repository, create a virtual environment with uv, install dependencies (uv pip install -e .), then start the server with python server.py. To integrate with Cursor, add the server configuration to ~/.cursor/mcp.json using the provided JSON template.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"terminal command runner mcp server": {
"neoforge-mcp-server": {
"command": "uv",
"args": [
"venv"
]
}
}
}
}McpServers
{
"neoforge-mcp-server": {
"command": "uv",
"args": [
"venv"
]
}
}Terminal Command Runner MCP Server
A powerful Model Control Protocol (MCP) server that provides terminal command execution and file system management capabilities for AI assistants through a RESTful API interface.
🌟 Features
Terminal Management
- Execute commands with configurable timeouts - Manage long-running processes in the background - Fetch output from active command sessions - List all active sessions and system processes - Terminate or kill processes - Command blacklisting for securityFile System Operations
- Read and write files - Create directories - List directory contents - Move/rename files - Search for files using glob patterns - Get detailed file informationAdvanced Features
- Precise text editing with search and replace - System information retrieval - Mathematical expression evaluation🚀 Quick Start
Prerequisites
- Python 3.13+ - uv package manager (recommended)Installation
1. Clone the repository:
git clone https://github.com/neoforge-dev/neoforge-mcp-server.git
cd python-server-mcp
2. Create a virtual environment and install dependencies:
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install -e .
3. Start the MCP server:
python server.py
The server will start on http://0.0.0.0:8000.
🧪 Testing
The project includes a comprehensive test suite to verify functionality:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
