MCP Terminal Server

🚀 @modelcontextprotocol/server-terminal

このプロジェクトは、モデルコンテキストプロトコル（MCP）用に実装されたターミナルサーバーです。ターミナルコマンドとnpm操作に対する安全で制御可能なアクセスを提供します。

✨ 主な機能

• 完全な制御権限でシェルコマンドを実行する機能
• 組み込みの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