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)

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.