MCP Terminal Tool Server
Click on "Deploy 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., "@MCP Terminal Tool Server List all files in my 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.
MCP Terminal Tool Server
This is a simple MCP server built with the MCP Python SDK. It exposes a single tool called terminal_tool that allows users to run terminal commands and returns their output.
Requirements
Python 3.8+
MCP Python SDK (
pip install mcp-sdk)
Related MCP server: MCP Terminal Server
Running the Server
python server.pyExposed Tool
terminal_tool
Description: Run a terminal command and return its output as a string.
Arguments:
command(str): The terminal command to execute.
Returns:
Output of the command as a string (stdout or stderr).
Note: Use with caution. This tool executes arbitrary shell commands on the server.
MCP Inspector & Claude Configuration
To connect this server to the MCP Inspector, Claude (Anthropic), or other MCP-compatible clients, use a configuration like the following:
{
"mcpServers": {
"terminal_tool": {
"command": "uv",
"args": [
"--directory",
"/path/to/your/project",
"run",
"server.py"
]
}
}
}Replace
/path/to/your/projectwith the absolute path to your project directory.This configuration will launch the server using
uvand connect via stdio transport (default).Claude (Anthropic) users: You can add this configuration to your Claude MCP settings to enable tool use with your local server.
For HTTP transport, start the server manually with
python server.py(oruv run server.py) and connect to the appropriate URL in the Inspector.
Available Tools
1 toolterminal_toolB
Run a terminal command and return its output as a string.
Inputs: command (required). Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 1 tool
With only one tool, there is no possibility of confusion or overlap between tools. The tool has a single, clear purpose: running terminal commands and returning output.
The single tool name 'terminal_tool' follows a consistent noun_noun pattern, though with only one tool, consistency is inherently perfect. There are no deviations or mixed conventions to evaluate.
A single tool for a terminal server is too few for the apparent scope, as it lacks coverage for common terminal operations like listing files, navigating directories, or managing processes. This minimal set will likely cause agent failures due to missing functionality.
The tool surface is severely incomplete for a terminal server. While 'terminal_tool' can run arbitrary commands, there are significant gaps: no dedicated tools for basic operations (e.g., ls, cd, pwd, ps) or structured outputs, forcing agents to rely on raw command parsing and increasing error risk.
Related MCP Connectors
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
Termalin's hosted MCP server. Claude, ChatGPT or any MCP client runs commands, moves files over SFTP, queries databases and reads server metrics and monitoring alerts on your servers, keylessly through Termalin Connectors: no SSH key is handed over and no inbound port is opened. Per-host command policy and an audit log. Needs a termal.in Pro or Team account (new accounts start with a 14-day Pro trial).
Related MCP Servers
- AlicenseCqualityDmaintenanceA server that enables AI assistants to execute terminal commands and retrieve outputs via the Model Context Protocol (MCP).326MIT
- FlicenseNot gradedqualityDmaintenanceA simple MCP server that allows running terminal commands with output capture, enabling command execution on the host system from MCP-compatible clients like Claude Desktop.1-
- FlicenseNot gradedqualityNot gradedmaintenanceA simple MCP server that provides a terminal tool for executing shell commands with safety features like timeouts and error handling.-
- FlicenseAqualityDmaintenanceA lightweight MCP server that provides AI assistants with access to a system's terminal through a secure terminal tool. It enables users to execute shell commands and receive stdout, stderr, and exit codes directly within an MCP-compatible client.1-