drio
Open app

Terminal MCP Server

Source

MCP server for executing terminal commands through Claude Desktop

Catalog onlyCatalog onlySTDIO

Overview

Terminal MCP Server is a Model Context Protocol server allowing execution of terminal commands via Claude Desktop.

To use the Terminal MCP Server, clone the repository, install dependencies, and configure it through Claude Desktop to execute commands.

  • Execute terminal commands with arguments and options - Navigate directories while maintaining context - Capture output, error messages, and exit codes with proper formatting - Fetch detailed terminal environment information
  1. Executing shell commands directly from Claude Desktop
  2. Changing directories while keeping track of previous states
  3. Obtaining terminal environmental data for debugging or scripting

Add to your AI client

Use these steps to connect Terminal MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "terminal-stat-guy": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-terminal-stat-guy"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "terminal-stat-guy": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-terminal-stat-guy"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "terminal-stat-guy": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-terminal-stat-guy"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "terminal-stat-guy": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-terminal-stat-guy"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "terminal-stat-guy": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-terminal-stat-guy"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "terminal-stat-guy": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-terminal-stat-guy"
      ]
    }
  }
}

FAQ

What are the prerequisites for using this server?

You need Node.js v18 or higher, TypeScript, and Claude Desktop.

How do I install the Terminal MCP Server?

Clone the repository, install dependencies, and build the project following the instructions in the documentation.

Is permission needed for executing commands?

Yes, explicit user permission is required through Claude Desktop for command execution.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":353,"uuid":"ec6a9027-8d25-4eb5-97ae-b92e3f011b48","name":"terminal","title":"Terminal MCP Server","description":"MCP server for executing terminal commands through Claude Desktop","avatar_url":"https://avatars.githubusercontent.com/u/11217678?v=4","created_at":"2024-12-13T13:20:55.545Z","updated_at":"2024-12-13T15:09:08.155Z","status":"created","author_name":"stat-guy","author_avatar_url":"https://avatars.githubusercontent.com/u/11217678?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/stat-guy/terminal","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":null,"user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]

Developer tools