Terminal Command Runner MCP Server

Name: Terminal Command Runner MCP Server
Author: neoforge-dev

@neoforge-dev

Repository

About Terminal Command Runner MCP Server

NeoMCP server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "neoforge-mcp-server": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.

Comments

More Developer Tools MCP servers

Sentry

modelcontextprotocol

Model Context Protocol Servers

88.1K

Unity MCP (Server + Plugin)

IvanMurzak

AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for fr

3.5K