MCP Console Automation

🚀 MCPコンソール自動化サーバー

このサーバーは、AIアシスタントがコンソールアプリケーションと完全に対話し、出力を監視し、エラーを検出し、ターミナルワークフローを自動化できるようにする、本番環境で使用可能なモデルコンテキストプロトコル（MCP）サーバーです。これは、Playwrightがウェブブラウザに対して行うことと似ています。

🚀 クイックスタート

このMCPコンソール自動化サーバーは、AIアシスタントがコンソールアプリケーションとの対話を可能にし、出力の監視やエラー検出、ターミナルワークフローの自動化を実現します。以下に、サーバーのインストール、設定、利用方法を説明します。

✨ 主な機能

• 完全なターミナル制御：複数のコンソールセッションを同時に作成および管理できます。
• 対話的入力：テキスト入力や特殊キーシーケンス（Enter、Tab、Ctrl+Cなど）を送信できます。
• リアルタイム出力監視：コンソール出力をリアルタイムでキャプチャし、分析できます。
• ストリーミングサポート：長時間実行されるプロセスに対して効率的なストリーミングが可能です。
• 複数のコンソールタイプ：cmd、PowerShell、bash、zsh、shをサポートしています。
• 自動エラー検出：エラー、例外、スタックトレースを検出するための組み込みパターンがあります。
• セッション管理：最大50の同時セッションを作成、停止、管理できます。
• リソース管理：メモリ監視、自動クリーンアップ、セッション制限があります。
• コマンド実行：コマンドを実行し、タイムアウトをサポートして完了を待つことができます。
• パターンマッチング：特定の出力パターンが現れるまで待機できます。
• クロスプラットフォーム：Windows、macOS、Linuxでネイティブ依存関係なしで動作します。

📦 インストール

Windows（管理者としてPowerShellを使用）

git clone https://github.com/ooples/mcp-console-automation.git
cd mcp-console-automation
.\install.ps1 -Target claude  # or google, openai, custom, all

macOS/Linux

git clone https://github.com/ooples/mcp-console-automation.git
cd mcp-console-automation
chmod +x install.sh
./install.sh --target claude  # or google, openai, custom, all

手動インストール

git clone https://github.com/ooples/mcp-console-automation.git
cd mcp-console-automation
npm install --production
npm run build

📚 ドキュメント

設定

Claude Desktop用の設定

Claude Desktopの設定ファイルに以下を追加します。

Windows：%APPDATA%\Claude\claude_desktop_config.json macOS：~/Library/Application Support/Claude/claude_desktop_config.json Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "console-automation": {
      "command": "npx",
      "args": ["@mcp/console-automation"],
      "env": {
        "LOG_LEVEL": "info"
      }
    }
  }
}

その他のMCPクライアント用の設定

# サーバーを起動
mcp-console --log-level info

# またはnpxを使用
npx @mcp/console-automation --log-level info

利用可能なツール（合計12個）

console_create_session

コマンドを実行するための新しいコンソールセッションを作成します。

パラメーター：

• command（必須）：実行するコマンド
• args：コマンド引数の配列
• cwd：作業ディレクトリ
• env：環境変数のオブジェクト
• detectErrors：自動エラー検出を有効にする（デフォルト: true）
• timeout：セッションのタイムアウト（ミリ秒）

例：

{
  "command": "python",
  "args": ["script.py"],
  "cwd": "/path/to/project",
  "detectErrors": true
}

console_send_input

アクティブなコンソールセッションにテキスト入力を送信します。

パラメーター：

• sessionId（必須）：セッションID
• input（必須）：送信するテキスト

console_send_key

コンソールセッションに特殊キーシーケンスを送信します。

パラメーター：

• sessionId（必須）：セッションID
• key（必須）：送信するキー（enter、tab、up、down、ctrl+c、escapeなど）

console_get_output

コンソールセッションから出力を取得します。

パラメーター：

• sessionId（必須）：セッションID
• limit：返す出力行数の最大数

console_wait_for_output

コンソールで特定の出力パターンが現れるまで待機します。

パラメーター：

• sessionId（必須）：セッションID
• pattern（必須）：待機する正規表現パターン
• timeout：タイムアウト（ミリ秒、デフォルト: 5000）

console_execute_command

コマンドを実行し、完了を待ちます。

パラメーター：

• command（必須）：実行するコマンド
• args：コマンド引数
• cwd：作業ディレクトリ
• env：環境変数
• timeout：実行タイムアウト

console_detect_errors

コンソール出力を分析してエラーや例外を検出します。

パラメーター：

• sessionId：分析するセッションID
• text：直接分析するテキスト（セッションを使用しない場合）

console_stop_session

アクティブなコンソールセッションを停止します。

パラメーター：

• sessionId（必須）：停止するセッションID

console_list_sessions

すべてのアクティブなコンソールセッションをリストします。

console_resize_session

セッションのターミナルサイズを変更します。

パラメーター：

• sessionId（必須）：セッションID
• cols（必須）：列数
• rows（必須）：行数

console_clear_output

セッションの出力バッファをクリアします。

パラメーター：

• sessionId（必須）：セッションID

使用例

1. 開発サーバーの実行と監視

// 開発サーバー用のセッションを作成
const session = await console_create_session({
  command: "npm",
  args: ["run", "dev"],
  detectErrors: true
});

// サーバーが起動するのを待つ
await console_wait_for_output({
  sessionId: session.sessionId,
  pattern: "Server running on",
  timeout: 10000
});

// エラーを監視
const errors = await console_detect_errors({
  sessionId: session.sessionId
});

2. 対話的デバッグセッション

// Pythonデバッグセッションを開始
const session = await console_create_session({
  command: "python",
  args: ["-m", "pdb", "script.py"]
});

// ブレークポイントを設定
await console_send_input({
  sessionId: session.sessionId,
  input: "b main\n"
});

// 実行を続行
await console_send_input({
  sessionId: session.sessionId,
  input: "c\n"
});

// コードをステップ実行
await console_send_key({
  sessionId: session.sessionId,
  key: "n"
});

3. エラー検出付きの自動テスト

// テストを実行
const result = await console_execute_command({
  command: "pytest",
  args: ["tests/"],
  timeout: 30000
});

// テスト失敗をチェック
const errors = await console_detect_errors({
  text: result.output
});

if (errors.hasErrors) {
  console.log("Test failures detected:", errors);
}

4. 対話的CLIツールの自動化

// 対話的CLIツールを開始
const session = await console_create_session({
  command: "mysql",
  args: ["-u", "root", "-p"]
});

// パスワードを入力
await console_wait_for_output({
  sessionId: session.sessionId,
  pattern: "Enter password:"
});

await console_send_input({
  sessionId: session.sessionId,
  input: "mypassword\n"
});

// SQLコマンドを実行
await console_send_input({
  sessionId: session.sessionId,
  input: "SHOW DATABASES;\n"
});

エラー検出パターン

サーバーには、一般的なエラータイプを検出するための組み込みパターンが含まれています。

• 一般的なエラー（error:、ERROR:、Error:）
• 例外（Exception:、exception）
• 警告（Warning:、WARNING:）
• 致命的なエラー
• 失敗した操作
• 権限拒否エラー
• タイムアウト
• スタックトレース（Python、Java、Node.js）
• コンパイルエラー
• 構文エラー
• メモリエラー
• 接続エラー

開発

ソースからビルド

npm install
npm run build

開発モードで実行

npm run dev

テストを実行

npm test

型チェック

npm run typecheck

リント

npm run lint

アーキテクチャ

サーバーは以下の技術を使用して構築されています。

• node-pty：擬似ターミナルの作成と管理
• @modelcontextprotocol/sdk：MCPプロトコルの実装
• TypeScript：型安全性と開発者体験の向上
• Winston：構造化ロギング

コアコンポーネント

1. ConsoleManager：ターミナルセッション、入出力、ライフサイクルを管理します。
2. ErrorDetector：出力を分析してエラーや例外を検出します。
3. MCP Server：MCPツールを通じてコンソール機能を公開します。
4. Session Management：複数の同時コンソールセッションを処理します。

要件

• Node.js >= 18.0.0
• Windows、macOS、またはLinuxオペレーティングシステム
• 追加のビルドツールは必要ありません！

テスト

機能を検証するには、含まれているテストスイートを実行します。

node test-functionality.js

トラブルシューティング

一般的な問題

1. 権限拒否エラー：サーバーがプロセスを生成する権限を持っていることを確認してください。
2. node-ptyコンパイルエラー：プラットフォーム用のビルドツールをインストールしてください。
3. セッションが応答しない：コマンドがTTY対話を必要とするかどうかを確認してください。
4. 出力がキャプチャされない：一部のアプリケーションはstdoutを迂回して直接ターミナルに書き込む場合があります。

コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します（git checkout -b feature/AmazingFeature）。
3. 変更をコミットします（git commit -m 'Add some AmazingFeature'）。
4. ブランチにプッシュします（git push origin feature/AmazingFeature）。
5. プルリクエストを開きます。

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

サポート

問題、質問、または提案がある場合は、GitHubで問題を開いてください。 https://github.com/yourusername/mcp-console-automation/issues

ロードマップ

• [ ] ターミナルの録画と再生のサポートを追加する
• [ ] セッションの永続化と復元を実装する
• [ ] 特定の言語用のエラー検出パターンを追加する
• [ ] ターミナルマルチプレクシング（tmux/screen統合）をサポートする
• [ ] ウェブベースのターミナルビューアーを追加する
• [ ] セッション共有とコラボレーション機能を追加する
• [ ] パフォーマンスプロファイリングツールを追加する
• [ ] 人気のあるCI/CDシステムとの統合を実現する