MCP Terminal Server

🚀 @modelcontextprotocol/server-terminal

這是為模型上下文協議（MCP）實現的終端服務器，能為終端命令和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