@modelcontextprotocol/server-terminal

MCP协议的终端服务器实现。提供对终端命令和npm操作的安全且受控访问。

功能特性

• 带有完全控制的shell命令执行
• 内置的npm操作（安装、运行脚本）
• 超时处理
• 通过允许的命令列表实现安全性
• 环境变量管理
• 工作目录控制
• TypeScript支持

安装

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');

// 运行npm脚本
await terminal.runScript('build');

// 直接执行npm命令
await terminal.dev();  // npm run dev
await terminal.build();  // npm run build