ターミナルコントローラー MCP サーバー

「ターミナルコントローラー」MCP サーバーは何をするのか

ターミナルコントローラー MCP サーバーは、Model Context Protocol (MCP) サーバーであり、標準化されたインターフェース経由でターミナルコマンドの安全な実行、ディレクトリ移動、ファイルシステム操作を可能にします。これはAIアシスタントとホスト環境の橋渡し役となり、AIエージェントがシェルコマンドの実行、ディレクトリ管理、ファイル操作などをプログラム的に行えるようにします。セキュリティガードの組み込みやコマンド履歴のトラッキング、クロスプラットフォーム対応により、開発ワークフローを強化し、AIツールにマシンのターミナルやファイルシステムへの制御されたアクセスを提供します。これにより、AIアシスタントが開発者のためにシステムレベルのタスクを安全かつ標準化された方法で自動化・探索・管理できるようになります。

プロンプト一覧

リポジトリやドキュメントにプロンプトテンプレートは見つかりませんでした。

リソース一覧

リポジトリやドキュメントに明示的な MCP リソースは定義されていません。

ツール一覧

• コマンド実行: タイムアウト制御付きでターミナルコマンドを実行し、出力を詳細に取得できます。
• ディレクトリ管理: ディレクトリ内の移動や内容一覧表示を直感的なフォーマットで行えます。
• ファイル操作: ファイル内容の読み書き・更新・挿入・削除などを行い、行単位の精度で編集可能です。
• コマンド履歴: 最近のコマンド実行履歴を追跡・表示し、監査や再利用に役立ちます。

この MCP サーバーのユースケース

• 自動コマンド実行: 開発者はAIアシスタントにシェルコマンドの実行（ビルド・テスト・デプロイ等）を安全に指示でき、出力やエラーも取得できます。
• ディレクトリ・ファイル管理: AIエージェントがファイルやフォルダの整理・閲覧・操作を支援し、コードベース探索や環境構築の自動化を容易にします。
• セキュリティ重視のスクリプト実行: 危険なコマンドを防ぐガード機能で、AIへのターミナルアクセス時のリスクを低減します。
• システム監視・監査: コマンド履歴機能により実行履歴を追跡でき、監査やワークフローの透明性向上に寄与します。
• クロスプラットフォーム開発: Windows・UNIX 系両対応で、様々な環境で一貫した開発体験を実現します。

セットアップ方法

Windsurf

1. Python 3.11 以上がインストールされていることを確認します。
2. PyPI からパッケージをインストールします:

   pip install terminal-controller
   

3. MCP サーバーを追加するため、Windsurf の設定ファイルを編集します:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. 設定を保存し、Windsurf を再起動します。
5. MCP サーバーが稼働し、アクセス可能であることを確認します。

Claude

1. マシンに Python 3.11 以上をインストールします。
2. Claude Desktop では Smithery を使ってインストールします:

   npx -y @smithery/cli install @GongRzhe/terminal-controller-mcp --client claude
   

3. または、PyPI からインストールも可能です:

   pip install terminal-controller
   

4. Claude の設定に次を追加します:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

5. Claude Desktop を再起動し、MCP サーバーが検出されることを確認します。

Cursor

1. Node.js と Python 3.11 以上がインストールされていることを確認します。
2. terminal-controller をインストールします:

   pip install terminal-controller
   

3. MCP サーバーを Cursor の設定に追加します:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. 設定ファイルを保存し、Cursor を再起動します。
5. Cursor のツール一覧で統合が確認できるかチェックします。

Cline

1. Python 3.11 以上が利用可能であることを確認します。
2. MCP サーバーをインストールします:

   pip install terminal-controller
   

3. 次のスニペットを Cline の設定に追加します:

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. 変更を保存後、Cline を再起動します。
5. MCP インターフェース経由で簡単なコマンドを実行し、動作確認します。

API キーのセキュリティ対策

API キーやシークレットが必要な場合は、ハードコーディングせず環境変数を利用してください。設定例:

{
  "mcpServers": {
    "terminal-controller": {
      "command": "python",
      "args": ["-m", "terminal_controller"],
      "env": {
        "MY_API_KEY": "${MY_API_KEY_ENV_VAR}"
      },
      "inputs": {
        "api_key": "${MY_API_KEY_ENV_VAR}"
      }
    }
  }
}

この MCP をフロー内で使う方法

FlowHunt での MCP 利用

FlowHunt のワークフローに MCP サーバーを組み込むには、まずフローに MCP コンポーネントを追加し、AI エージェントと接続します:

MCP コンポーネントをクリックして設定パネルを開き、「システム MCP 設定」欄に以下の JSON 形式で MCP サーバー情報を入力します:

{
  "terminal-controller": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

設定後、AI エージェントはこの MCP をツールとして利用できるようになり、すべての機能・能力にアクセスできます。“terminal-controller” を実際の MCP サーバー名に、URL を自身の MCP サーバーURLに置き換えてください。

概要

上記の通り、ターミナルコントローラー MCP は安全な形でターミナル・ファイルシステムアクセスを提供しますが、プロンプトテンプレートや明示的リソースはありません。設定は十分にドキュメント化されており、クロスプラットフォーム対応です。ルートやサンプリングには言及がありません。全体として、DevOpsや自動化のコアニーズに実用的かつ安全、かつ比較的シンプルなサーバーです。

MCP スコア