Terminal Command Runner MCP Server

What is Terminal Command Runner MCP Server?

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, manage files, and perform system operations programmatically.

How to use Terminal Command Runner MCP Server?

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.

Key features of Terminal Command Runner MCP Server

• 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

Use cases of Terminal Command Runner MCP Server

• AI assistant executing shell commands and managing outputs
• Automated file system operations within a controlled environment
• Background process management for long-running tasks
• Secure command execution with blacklist enforcement
• Interactive file editing and system probing

FAQ from Terminal Command Runner MCP Server

What are the prerequisites for running the server?

Python 3.13+ and the uv package manager (recommended) are required.

How do I install and start the server?

Clone the repository, create a virtual environment with uv venv, activate it, run uv pip install -e ., and start the server with python server.py. It will listen on http://0.0.0.0:8000.

How can I configure the server with Cursor?

Add the server entry to ~/.cursor/mcp.json using the provided JSON configuration, specifying the path to uv and the server script.

What security measures are included?

The server uses command blacklisting to block dangerous commands, enforces file size limits for read operations, and includes safeguards for mathematical expression evaluation.

What transport protocol does the server use?

The server exposes a RESTful API interface over HTTP, running on port 8000 by default.