Terminal Hook

🚀 Terminal Hook

VSCode/Cursorの拡張機能で、ターミナルの出力をリアルタイムでキャプチャし、MCP（Model Context Protocol）を介してAIアシスタントに提供します。

🚀 クイックスタート

この拡張機能は、ターミナルの出力をリアルタイムでキャプチャし、MCPを介してAIアシスタントに提供することで、コマンドの実行中にAIがエラーやログ、コマンドの出力を自動的に参照できるようにします。

✨ 主な機能

• リアルタイムキャプチャ - ターミナルの出力をリアルタイムでキャプチャします。
• クリーンな出力 - 自動的にANSIコードやシェルのノイズを除去します。
• MCP統合 - ClaudeなどのAIアシスタントにターミナルデータを提供します。

📦 インストール

セットアップ手順については、INSTALL.mdを参照してください。

💻 使用例

基本的な使用法

システムの動作原理

┌─────────────────┐     stdio      ┌─────────────────┐     TCP      ┌─────────────────┐
│  Cursor/Claude  │◄──────────────►│  mcp-server.mjs │◄────────────►│ VSCode Extension│
│   (MCP Client)  │                │  (MCP Server)   │   port 9876  │ (Terminal Data) │
└─────────────────┘                └─────────────────┘              └─────────────────┘

1. VSCode拡張機能 は onDidWriteTerminalData API を介してターミナルの出力をキャプチャします。
2. MCPサーバー (mcp-server.mjs) は標準入出力を介してCursorと通信します。
3. TCPブリッジ はポート9876でMCPサーバーと拡張機能を接続します。

高度な使用法

MCPツールの使用

list_terminals

すべてのアクティブなターミナルをメタデータとともにリストします。

{
  "success": true,
  "count": 2,
  "terminals": [
    {
      "id": "terminal-0-zsh",
      "name": "zsh",
      "processId": 1234,
      "bufferLines": 150,
      "lastActivity": "2024-12-18T10:30:00.000Z"
    }
  ]
}

get_terminal_output

特定のターミナルから出力を取得します。 パラメータ:

• terminal_name (必須): ターミナルの名前またはID
• lines (オプション): 返す行数 (デフォルト: 100)

{
  "success": true,
  "terminal": "zsh",
  "output": "$ npm start\nServer running on port 3000\n...",
  "lines_returned": 50
}

🔧 技術詳細

開発手順

bun install
bun run compile
bun test

📄 ライセンス

MIT