MCP Terminal Server

🚀 @modelcontextprotocol/server-terminal

A terminal server implementation for the Model Context Protocol (MCP), providing secure and controlled access to terminal commands and npm operations.

🚀 Quick Start

This @modelcontextprotocol/server-terminal offers secure and controlled access to terminal commands and npm operations for the Model Context Protocol (MCP).

✨ Features

• Execute shell commands with full control.
• Built-in npm operations (installation, script running).
• Timeout handling.
• Security management through an allowed commands list.
• Environment variable management.
• Working directory control.
• TypeScript support.

📦 Installation

npm install @modelcontextprotocol/server-terminal

📚 Documentation

Add the following configuration to your MCP configuration:

{
  "terminal": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-terminal"],
    "autoApproveScope": ["execute_command", "npm_install", "npm_run"],
    "config": {
      "allowedCommands": ["npm", "node", "git"],
      "defaultTimeout": 30000,
      "defaultCwd": "/your/project/path",
      "environmentVariables": {
        "NODE_ENV": "development"
      }
    }
  }
}

💻 Usage Examples

Basic Usage

// Execute a command
const result = await terminal.executeCommand('ls', ['-la'], {
  cwd: '/some/path'
});

// Install an npm package
await terminal.install('typescript');

// Run an npm script
await terminal.runScript('build');

// Execute an npm command directly
await terminal.dev();  // npm run dev
await terminal.build();  // npm run build