Skip to main content
Glama
MCP Terminal Tool Server

MCP Terminal Tool Server

by gkgaurav31

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.py

Exposed 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/project with the absolute path to your project directory.

  • This configuration will launch the server using uv and 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 (or uv run server.py) and connect to the appropriate URL in the Inspector.

Available Tools

1 tool
terminal_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

    B3.4/5.0

    Scored across 1 tool

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness2/5

    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

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      A server that enables AI assistants to execute terminal commands and retrieve outputs via the Model Context Protocol (MCP).
      3
      26
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      A 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
      -
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      A simple MCP server that provides a terminal tool for executing shell commands with safety features like timeouts and error handling.
      -
    • F
      license
      A
      quality
      D
      maintenance
      A 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
      -