Copilot Terminal Mcp Server

🚀 Copilot Terminal MCP サーバー

GitHub Copilot と連携する、高度なターミナル管理用 MCP サーバー

GitHub Copilot および VS Code とシームレスに連携する、インテリジェントでノンブロッキングなターミナルで開発体験を向上させましょう。

✨ 機能

🔧 高度なターミナル管理

• 名前付きターミナル：任意の名前を付けてターミナルを作成・管理できます
• ノンブロッキング実行：GitHub Copilot をブロックせずにサーバーを起動できます
• リアルタイム出力：ターミナルの出力を即座に取得して監視できます
• 並列実行：複数のターミナルを競合なく同時に実行できます
• スマートリカバリー：エラー処理とプロセス復旧を自動で行います

⚡ パフォーマンスと信頼性

• 応答時間 < 10ms：超高速のコマンド実行
• タイムアウトの問題を解消：30 秒の待ち時間に悩まされることはありません
• エンタープライズグレードのロギング：包括的な監視とデバッグ
• クロスプラットフォーム対応：Windows、macOS、Linux

🚀 34 種類の強力なツール

1. createTerminal - カスタム設定で名前付きターミナルを作成
2. sendCommand - ノンブロッキングでコマンドを実行
3. getTerminalOutput - 出力をリアルタイムで取得
4. listTerminals - ターミナルの包括的な一覧を表示
5. deleteTerminal - ターミナルを整理して管理
6. sendCommandAndWait - 簡単な操作に便利なヘルパー
7. cancelCommand - プロセスを安全に終了
8. getTerminalState - 高度なターミナル診断
9. searchOutput - ターミナル出力を検索
10. tailOutput - Unix の tail のようにターミナル出力を監視 ... ターミナルを自在に扱うための、さらに 24 種類以上の専用ツールを利用できます！

📦 とても簡単なインストール

オプション 1：自動インストール（推奨）

# One-command installation and configuration
npx copilot-terminal-mcp-server install

これだけです！ MCP サーバーは自動的に次の状態になります：

• ✅ グローバルにインストール済み
• ✅ VS Code に設定済み
• ✅ GitHub Copilot ですぐに利用可能

オプション 2：NPM グローバルインストール

# Global installation
npm install -g copilot-terminal-mcp-server

# Auto-configuration
copilot-terminal-install install

オプション 3：ステータスの確認

# Verify installation status
npx copilot-terminal-mcp-server status

🎯 GitHub Copilot ですぐに使う

インストールしたら、GitHub Copilot Chat で次の便利なコマンドを使えます：

🚀 開発ワークフロー

🏃‍♂️ Start development server:
@workspace Launch npm start in terminal "dev-server"

🧪 Run tests:
@workspace Run tests in watch mode in terminal "tests"

🔍 Monitor logs:
@workspace Show output from all active terminals

🛠️ Multi-project setup:
@workspace Launch backend AND frontend simultaneously

📊 高度な操作

🔍 Debug investigation:
@workspace Search for "ERROR" in terminal "api-server" output

📈 Performance monitoring:
@workspace Show terminal states and performance metrics

🧹 Cleanup:
@workspace Stop all inactive terminals older than 10 minutes

🔄 Process management:
@workspace Restart "app-server" if it crashed

💡 使用例

例 1：フルスタック開発

@workspace Create terminal "backend" and run "npm run dev"
@workspace Create terminal "frontend" and run "npm start" 
@workspace Monitor both terminals for errors

例 2：テストパイプライン

@workspace Run unit tests in terminal "unit-tests"
@workspace Run integration tests in terminal "integration"
@workspace Show test coverage from both terminals

例 3：Docker ワークフロー

@workspace Start docker-compose in terminal "containers"
@workspace Monitor container logs in real-time
@workspace Stop containers gracefully when done

🎛️ 設定

サーバーは最適なデフォルト設定で自動構成されます。mcp.json で手動設定することもできます：

{
  "servers": {
    "copilot-terminal": {
      "command": "npx",
      "args": ["copilot-terminal-mcp-server", "start"],
      "env": {
        "NODE_ENV": "production",
        "MAX_TERMINALS": "20",
        "COMMAND_TIMEOUT": "30000"
      }
    }
  }
}

🔧 トラブルシューティング

❌ 「MCP サーバーが見つかりません」

npx copilot-terminal-mcp-server install --force

❌ 「アクセスが拒否されました」

# Windows (Administrator)
npm install -g copilot-terminal-mcp-server

# macOS/Linux  
sudo npm install -g copilot-terminal-mcp-server

❌ VS Code が認識しない場合

1. VS Code を再起動します
2. GitHub Copilot Chat を開きます
3. テストします：@workspace List active terminals

🏗️ アーキテクチャ

┌─────────────────────────────────────────────────────────────┐
│                    GitHub Copilot Chat                     │
├─────────────────────────────────────────────────────────────┤
│                       MCP Protocol                         │
├─────────────────────────────────────────────────────────────┤
│              Copilot Terminal MCP Server                   │
│  ┌─────────────────┐ ┌─────────────────┐ ┌──────────────┐   │
│  │ Terminal Manager│ │  Smart Executor │ │ Tool Registry│   │
│  │                 │ │                 │ │              │   │
│  │ • Create        │ │ • Non-blocking  │ │ • 34 Tools   │   │
│  │ • Monitor       │ │ • Parallel      │ │ • Auto-reg   │   │
│  │ • Cleanup       │ │ • Recovery      │ │ • Extensible │   │
│  └─────────────────┘ └─────────────────┘ └──────────────┘   │
├─────────────────────────────────────────────────────────────┤
│                    VS Code Terminal API                     │
└─────────────────────────────────────────────────────────────┘

📊 パフォーマンス指標

• コマンド応答：平均 < 10ms
• メモリ使用量：インスタンスあたり < 50MB
• ターミナル容量：同時に 20 台以上のターミナル
• 稼働率：99.9% の信頼性
• エラー復旧：自動再起動まで < 1 秒

🛠️ 開発

# Clone repository
git clone https://github.com/menoxz/Copilot-terminal-MCP.git
cd Copilot-terminal-MCP

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run in development mode
npm run dev

# Run tests
npm test

📚 ドキュメント

• クイックインストールガイド - 30 秒で使い始められます
• 使用例 - 実際のシナリオ
• API リファレンス - ツールの完全なドキュメント
• トラブルシューティング - よくある問題と解決方法

🤝 コントリビューション

コントリビューションを歓迎します！詳細はコントリビューションガイドをご覧ください。

開発環境のセットアップ

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

📈 ロードマップ

• Web ダッシュボード：ブラウザベースのターミナル監視
• クラウドターミナル：リモートサーバーのターミナル管理
• AI 統合：LLM を活用したコマンドの提案
• プラグインシステム：カスタムツール開発フレームワーク
• エンタープライズ機能：SSO、監査ログ、チーム管理

🐛 サポート

• Issue：GitHub Issues
• ディスカッション：GitHub Discussions
• メール：[email protected]

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEファイルをご覧ください。

⭐ スター履歴

このプロジェクトがお役に立った場合は、ぜひスターを付けてください！⭐

---

🚀 今日から開発ワークフローを変革しましょう！

❤️ を込めて menoxz が作成しました