@modelcontextprotocol/server-terminal

简介

@modelcontextprotocol/server-terminal 是为 Model Context Protocol (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']);

// 安装 npm 包
await terminal.install('typescript');

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

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

主要特性

• 安全执行 shell 命令
• 内置 npm 操作支持
• 超时处理与工作目录控制
• 环境变量管理
• 命令白名单机制

了解更多详细信息，请查阅完整文档。