MCP Terminal Server

by RinardNick

10 stars
366 downloads
Not rated
GitHub

About

An MCP server that provides secure terminal access for Claude and other LLMs

Details

Author
RinardNick
GitHub stars
10
Downloads
366
Categories
Developer Tools

- Execute shell commands with output capture and error handling
- Restrict allowed commands and prevent command injection
- Command timeouts and maximum output size limits
- Standard MCP message format with capability advertisement
- Streaming output support for long-running commands

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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Terminal 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.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install the package using uv pip install mcp-terminal, then configure Claude Desktop with the command and args fields, specifying allowed commands, timeout, and maximum output size. The server can also be tested with the MCP Inspector tool.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

{
    "mcp-terminal": {
        "command": "uv",
        "args": [
            "venv"
        ]
    }
}

MCP Terminal Server

A secure terminal execution server implementing the Model Context Protocol (MCP). This server provides controlled command execution capabilities with security features and resource limits.

Features

- Command Execution: Execute shell commands with output capture and error handling
- Security Controls: Restrict allowed commands and prevent command injection
- Resource Controls:
- Command timeouts
- Maximum output size limits
- MCP Protocol Support:
- Standard MCP message format
- Capability advertisement
- Streaming output support

Development

Local Setup

```bash

No reviews yet — be the first

Sign in to leave a review

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

Email sign in

No reviews posted yet.