@modelcontextprotocol/server-terminal

Name: @modelcontextprotocol/server-terminal
Author: RichardTheuws

@RichardTheuws

代码仓库

关于 @modelcontextprotocol/server-terminal

Terminal server implementation for Model Context Protocol

基本信息

分类

开发工具

传输方式

stdio

发布者

RichardTheuws

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is @modelcontextprotocol/server-terminal?

@modelcontextprotocol/server-terminal is an MCP server that provides secure, controlled access to terminal commands and npm operations over the Model Context Protocol. It lets AI agents execute shell commands, install packages, and run scripts in a sandboxed environment with configurable security constraints.

How to use @modelcontextprotocol/server-terminal?

Install the package via npm, then add the server to your MCP configuration file. In the config, you define an allowedCommands whitelist, a default timeout, a working directory, and optional environment variables. Once configured, you invoke operations like executeCommand, install, or runScript through the MCP client.

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 and working directory control
TypeScript support

Use cases of @modelcontextprotocol/server-terminal

Automate build and test workflows by running npm scripts
Execute safe, predefined shell commands from an AI assistant
Install npm packages and manage dependencies programmatically
Run development servers (npm run dev) or builds (npm run build) via MCP

FAQ from @modelcontextprotocol/server-terminal

What commands can the server run?

Only commands listed in the allowedCommands configuration array (e.g., npm, node, git) may be executed. This provides a security boundary.

How are long-running commands handled?

The server enforces a configurable defaultTimeout (default: 30000 ms). Commands that exceed the timeout are terminated.

What runtime dependencies are required?

Node.js and npm are required. The server itself is installed via npm and runs as a Node.js process.

Where does the server execute commands?

Commands run in the directory specified by defaultCwd in the configuration. This can be overridden per invocation via the cwd option.

How are environment variables managed?

You can set a base set of environment variables in the configuration under environmentVariables. These are passed to every command.

开发工具分类下的更多 MCP 服务器

MCP Inspector

modelcontextprotocol

Visual testing tool for MCP servers

10.3K

TalkToFigma

sonnylazuardi

TalkToFigma: MCP integration between AI Agent (Cursor, Claude Code, Codex) and Figma, allowing Agentic AI to communicate with Figma for reading designs and modifying them programmatically.

6.9K