Terminal Controller MCP

🚀 ターミナルコントローラ for MCP

このモデルコンテキストプロトコル（MCP）サーバは、標準インターフェースを通じて、安全なターミナルコマンドの実行、ディレクトリのナビゲーション、およびファイルシステム操作を実現します。

✨ 主な機能

• コマンド実行：タイムアウト制御付きのターミナルコマンドの実行と、包括的な結果フィードバック
• ディレクトリナビゲーション：ファイルシステム構造の簡単な閲覧と操作
• ファイルシステム操作：ファイルとディレクトリの効率的な管理

📦 インストール

Smithery を通じたインストール

# ターミナルコントローラ for MCP をインストール
# MCP 環境を設定
# サービスを起動

Python パッケージを使用したインストール

pip install terminal-controller-mcp

💻 使用例

基本的な使用法

# サンプル設定ファイル
{
    "server_address": "localhost",
    "port": 5000,
    "timeout": 3600
}

高度な使用法

# ターミナルコントローラサービスを実行
python -m terminal_controller

# または uvx ツールを使用する場合：
uvx terminal_controller

📚 ドキュメント

機能特性

• コマンド実行：システムコマンドを実行し、リアルタイムの出力と結果を取得
• ファイル操作：読み取り、書き込み、挿入、更新、削除などの機能
• ディレクトリ管理：ディレクトリ構造を閲覧し、基本的なファイル管理操作を実行
• セキュリティ機構：危険なコマンドの実行を防止するための組み込みブラックリスト機構

セキュリティに関する注意事項

• すべてのコマンド実行にはタイムアウト制御があり、デフォルトは3600秒です。
• rm -rf /、format、mkfs などの危険なコマンドの使用は禁止されています。
• 操作結果は詳細に記録され、監査されます。

制限と不備

• コマンドはタイムアウト時間内にのみ結果を返します。
• デフォルトでは、サーバは現在のユーザと同じファイルシステム権限を持ちます。
• 一部の対話型コマンドは、対話型インターフェースに依存しているため、正常に動作しない場合があります。

トラブルシューティング

1. Python バージョンが 3.11 以上であることを確認してください。
2. MCP クライアントの設定が正しいことを確認してください。
3. ターミナルコントローラを直接実行して、エラーがないことを確認してください。

   python -m terminal_controller
   

4. uvx 関連の問題がある場合は、以下を試してください。

   uvx terminal_controller
   

📄 ライセンス

MIT