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许可证。