Allows cloning repositories from GitHub to set up the terminal.mcp server, and provides integration with GitHub-hosted tools like the MCP Inspector.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@terminal-mcprun ls -la to list files in the current directory"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
🛠️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
Related MCP server: Terminal Controller for MCP
🚀 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.