Richardtheuws MCP Terminal Server

🚀 @modelcontextprotocol/server-terminal

MCP協議的終端服務器實現，為終端命令和npm操作提供安全且可控的訪問途徑，有效解決了在特定環境下對命令執行和npm操作進行安全管控的問題，提升了操作的安全性和可控性。

🚀 快速開始

本項目是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