Allows cloning repositories from GitHub to set up the terminal.mcp server, and provides integration with GitHub-hosted tools like the MCP Inspector.
🛠️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
2. Run the MCP server
This starts the MCP server over stdio
, waiting for clients (like ChatGPT, Claude, or custom clients) to connect.
🛠️ Tool: run
The server executes the command and returns the output. Supports safe execution via schema-validated tools.
🧪 Test with MCP Inspector
Use MCP Inspector:
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.
This server cannot be installed
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.
Related MCP Servers
- AsecurityAlicenseAqualityA 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 -1113PythonMIT License
- AsecurityAlicenseAqualityAn MCP server that enables secure terminal command execution, directory navigation, and file system operations through a standardized interface for LLMs.Last updated -1070PythonMIT License
- -securityFlicense-qualityA 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 -983JavaScript
- AsecurityAlicenseAqualityAn 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 -93466JavaScriptMIT License