Model Context Protocol Terminal Server - Quick Start

概述

@modelcontextprotocol/server-terminal 为模型上下文协议(MCP)提供终端服务器支持，允许安全地执行终端命令和npm操作。

安装

npm install @modelcontextprotocol/server-terminal

配置

在MCP配置文件中添加：

{
  "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"
      }
    }
  }
}

基本用法

// 执行命令
const result = await terminal.executeCommand('ls', ['-la'], {
  cwd: '/some/path'
});

// NPM操作
await terminal.install('typescript');       // 安装包
await terminal.runScript('build');          // 运行脚本
await terminal.build();                     // 等同于 npm run build
await terminal.dev();                       // 等同于 npm run dev

主要功能

• 可控制的shell命令执行
• 内置npm操作支持
• 安全控制（通过允许的命令列表）
• 可配置的超时处理
• 环境变量管理
• 工作目录控制