Terminal Command Runner MCP Server

by neoforge-dev

242 downloads Not rated yet

GitHub

Developer Tools

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…

Explore

- Precise text editing with search and replace
- System information retrieval
- Mathematical expression 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 Server

Command (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

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

- Python 3.13+
- uv package manager (recommended)

uv pip install -r requirements.txt

Configure Cursor to use this MCP service by adding it to your ~/.cursor/mcp.json file:

{
  "mcpServers": {
    "NeoMCP": {
      "command": "/path/to/uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "/path/to/python-server-mcp/server.py"
      ]
    }
  }
}

`execute_command`

Run commands with configurable timeouts

`read_output`

Get output from running processes

`force_terminate`

Stop a running command

`list_sessions`

Show all active command sessions

`list_processes`

View all system processes

`kill_process`

Kill processes by PID

`block_command`

Add commands to the blacklist

`unblock_command`

Remove commands from the blacklist

`read_file`

Read file contents

`write_file`

Write data to a file

`create_directory`

Create new directories

`list_directory`

List contents of a directory

`move_file`

Move or rename files and directories

`search_files`

Find files matching patterns

`get_file_info`

Get detailed file information

`edit_block`

Apply precise text replacements using diff-like syntax

`system_info`

(resource): Get detailed system information

`calculate`

Evaluate mathematical expressions

- execute_command: Run commands with configurable timeouts
- read_output: Get output from running processes
- force_terminate: Stop a running command
- list_sessions: Show all active command sessions
- list_processes: View all system processes
- kill_process: Kill processes by PID
- block_command: Add commands to the blacklist
- unblock_command: Remove commands from the blacklist

- read_file: Read file contents
- write_file: Write data to a file
- create_directory: Create new directories
- list_directory: List contents of a directory
- move_file: Move or rename files and directories
- search_files: Find files matching patterns
- get_file_info: Get detailed file information

- edit_block: Apply precise text replacements using diff-like syntax

- system_info (resource): Get detailed system information
- calculate: Evaluate mathematical expressions

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"
        ]
    }
}

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 security

File System Operations

- Read and write files - Create directories - List directory contents - Move/rename files - Search for files using glob patterns - Get detailed file information

Advanced 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

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Explore

Setting up with Highlight

From the repository

execute_command

read_output

force_terminate

list_sessions

list_processes

kill_process

block_command

unblock_command

read_file

write_file

create_directory

list_directory

move_file

search_files

get_file_info

edit_block

system_info

calculate

Claude Desktop / Cursor

McpServers

🌟 Features

Terminal Management

File System Operations

Advanced Features

🚀 Quick Start

Prerequisites

Installation

🧪 Testing

More like this

Sentry

Github

Git

GitLab

`execute_command`

`read_output`

`force_terminate`

`list_sessions`

`list_processes`

`kill_process`

`block_command`

`unblock_command`

`read_file`

`write_file`

`create_directory`

`list_directory`

`move_file`

`search_files`

`get_file_info`

`edit_block`

`system_info`

`calculate`