Skip to main content
Glama

terminal-mcp

🛠️terminal.mcp

A secure and pluggable MCP server to run terminal commands on your local machine or cloud server — remotely, safely, and with LLMs or agentic clients.


✨ Features

  • 🖥️ Execute terminal commands securely via the Model Context Protocol (MCP)
  • 🌐 Works locally or on cloud servers (run anywhere!)
  • 🔒 Designed for safety with parameterized tools and isolated execution
  • 🤖 Plug into LLMs, autonomous agents, or even your own apps
  • 🧩 Simple Go SDK-based implementation with full MCP Inspector support

🚀 Getting Started

1. Clone the repo

git clone https://github.com/your-username/terminal.mcp.git cd terminal.mcp

2. Run the MCP server

go run main.go

This starts the MCP server over stdio, waiting for clients (like ChatGPT, Claude, or custom clients) to connect.


🛠️ Tool: run

{ "command": "ls -la" }

The server executes the command and returns the output. Supports safe execution via schema-validated tools.


🧪 Test with MCP Inspector

Use MCP Inspector:

npx @modelcontextprotocol/inspector -- go run main.go

Then open http://localhost:6274 and test the run tool interactively.


☁️ Deploy on Cloud (optional)

You can run this server on any VPS, container, or cloud function. Just expose stdin/stdout or use a TCP transport (WIP).


📦 Built With


🔐 Security Notice

This server executes terminal commands. Use only with authenticated and trusted clients. Avoid deploying it publicly without a secure transport + auth layer.

-
security - not tested
F
license - not found
-
quality - not tested

A secure and pluggable MCP server to run terminal commands on your local machine or cloud server — remotely, safely, and with LLMs or agentic clients.

  1. ✨ Features
    1. 🚀 Getting Started
      1. 1. Clone the repo
      2. 2. Run the MCP server
    2. 🛠️ Tool: run
      1. 🧪 Test with MCP Inspector
        1. ☁️ Deploy on Cloud (optional)
          1. 📦 Built With
            1. 🔐 Security Notice

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                A secure shell command execution server implementing the Model Context Protocol (MCP). This server allows remote execution of whitelisted shell commands with support for stdin input.
                Last updated -
                1
                113
                Python
                MIT License
                • Apple
              • A
                security
                A
                license
                A
                quality
                An MCP server that enables secure terminal command execution, directory navigation, and file system operations through a standardized interface for LLMs.
                Last updated -
                10
                70
                Python
                MIT License
                • Apple
              • -
                security
                F
                license
                -
                quality
                A simple MCP server that allows accessing and executing shell commands on a VM machine through a web-based terminal interface, with automatic tunneling to make the VM accessible from anywhere.
                Last updated -
                98
                3
                JavaScript
              • A
                security
                A
                license
                A
                quality
                An MCP server that enables secure execution of shell commands across Windows, macOS, and Linux with built-in whitelisting and approval mechanisms for enhanced security.
                Last updated -
                9
                346
                6
                JavaScript
                MIT License
                • Linux
                • Apple

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/ParthKapoor-dev/terminal.mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server