terminal.mcp

ParthKapoor-dev/terminal.mcp

3.1

If you are the rightful owner of terminal.mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

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.

Tools
1
Resources
0
Prompts
0

🛠️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.