Terminal MCP Server

by MCP-Mirror

301 downloads
Not rated
GitHub

About

Terminal MCP Server is a Model Context Protocol (MCP) server that allows executing commands on local or remote hosts. It provides a simple yet powerful interface for AI models and other applications to execute system commands, either on the local machine or on remote hosts via…

Details

Author
MCP-Mirror
Downloads
301
Categories
Developer Tools

- Execute commands directly on the local machine
- Execute commands on remote hosts via SSH
- Persistent sessions that reuse the same terminal environment (default 20 minutes)
- Set custom environment variables per command
- Connect via stdio or SSE (Server-Sent Events)

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Terminal MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install manually via git clone, npm install, and npm run build, or automatically via Smithery using npx -y @smithery/cli install @weidwonder/terminal-mcp-server --client claude. Start the server in stdio mode with npm start or in SSE mode with npm run start:sse. Configure the server URL in your AI assistant’s MCP settings file (e.g., Claude Desktop, Cline, or Roo Code).

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "terminal mcp server": {
            "weidwonder_terminal-mcp-server": {
                "command": "npx",
                "args": [
                    "-y",
                    "@smithery/cli",
                    "install",
                    "@weidwonder/terminal-mcp-server",
                    "--client",
                    "claude"
                ]
            }
        }
    }
}

McpServers

{
    "weidwonder_terminal-mcp-server": {
        "command": "npx",
        "args": [
            "-y",
            "@smithery/cli",
            "install",
            "@weidwonder/terminal-mcp-server",
            "--client",
            "claude"
        ]
    }
}

Terminal MCP Server

smithery badge

中文文档

Terminal MCP Server is a Model Context Protocol (MCP) server that allows executing commands on local or remote hosts. It provides a simple yet powerful interface for AI models and other applications to execute system commands, either on the local machine or on remote hosts via SSH.

Features

- Local Command Execution: Execute commands directly on the local machine
- Remote Command Execution: Execute commands on remote hosts via SSH
- Session Persistence: Support for persistent sessions that reuse the same terminal environment for a specified time (default 20 minutes)
- Environment Variables: Set custom environment variables for commands
- Multiple Connection Methods: Connect via stdio or SSE (Server-Sent Events)

Installation

Installing via Smithery

To install terminal-mcp-server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @weidwonder/terminal-mcp-server --client claude

Manual Installation

```bash
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.