MCP.so
Sign In

@modelcontextprotocol/server Terminal MCP Server

@MCP-Mirror

Basic information

Category

Developer Tools

Transports

stdio

Author

MCP-Mirror

About @modelcontextprotocol/server Terminal MCP Server

Mirror of

#mcp-terminal#terminal-server#model-context-protocol

@modelcontextprotocol/server Terminal MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

@modelcontextprotocol/server Terminal MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is @modelcontextprotocol/server-terminal?

A terminal server implementation for the Model Context Protocol (MCP). It provides secure and controlled access to shell commands and npm operations, designed for MCP integrations that need to run terminal tasks programmatically.

How to use @modelcontextprotocol/server-terminal?

Install the package via npm, then add the provided JSON configuration to your MCP config file. The configuration defines allowed commands, a default timeout, a working directory, and environment variables.

Key features of @modelcontextprotocol/server-terminal

  • Execute shell commands with full control
  • Built-in npm operations (install, run scripts)
  • Timeout handling for long-running commands
  • Security through an allowed commands list
  • Environment variables management
  • Working directory control
  • TypeScript support

Use cases of @modelcontextprotocol/server-terminal

  • Run build, dev, or test scripts in a project directory
  • Install npm packages automatically as part of an MCP workflow
  • Execute controlled shell commands (e.g., git operations) with timeouts
  • Manage development environment variables for consistent command execution

Frequently asked questions

1

What are the required configuration fields?

The `allowedCommands` list, `defaultTimeout`, and `defaultCwd` are configurable; the README shows `npm`, `node`, and `git` as examples for allowed commands and a 30-second timeout.

2

How does the server enforce security?

It restricts which commands can be run via the `allowedCommands` configuration array—only those listed (e.g., `npm`, `node`, `git`) are permitted.

3

What npm operations are built-in?

The server exposes `install()`, `runScript()`, `dev()`, and `build()` methods for common npm tasks like installing packages and running scripts.

4

Does it support custom environment variables?

Yes, you can set environment variables like `NODE_ENV` through the `environmentVariables` configuration object.

5

What runtime or dependencies does it require?

It requires Node.js and npm to be installed, and it is installed via `npm install @modelcontextprotocol/server-terminal`.

Comments

More Developer Tools MCP servers