Terminal Hook

🚀 終端鉤子

這是一款VSCode/Cursor擴展程序，它能夠即時捕獲終端輸出，並通過MCP（模型上下文協議）將其提供給AI助手使用。

🚀 快速開始

本擴展程序解決了在與AI助手交流時，需要手動複製粘貼終端輸出並引用的繁瑣問題。藉助此擴展，AI助手可以主動讀取你的終端信息，如檢查錯誤、日誌和命令輸出，而無需你中斷操作來獲取更多信息。其他MCP工具也能利用終端數據實現自動化。

✨ 主要特性

• 即時捕獲：即時捕獲所有終端輸出。
• 輸出清理：自動去除ANSI代碼和shell噪音。
• 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許可證。