Copilot Terminal Mcp Server

🚀 Copilot Terminal MCP Server

集成 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% 可靠性
• 错误恢复：< 1s 自动重启

🛠️ 开发

# 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. Fork 此仓库
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add amazing feature'）
4. 将分支推送到远程仓库（git push origin feature/amazing-feature）
5. 创建 Pull Request

📈 路线图

• Web 控制面板：基于浏览器的终端监控
• 云终端：远程服务终端管理
• AI 集成：由大模型驱动的命令建议
• 插件系统：自定义工具开发框架
• 企业功能：SSO、审计日志、团队管理

🐛 支持

• 问题反馈：GitHub Issues
• 讨论：GitHub Discussions
• 电子邮件：[email protected]

📄 许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

⭐ Star 历史

如果此项目对你有所帮助，请考虑为它点亮一颗星！⭐

---

🚀 立即改变你的开发工作流！

由 menoxz 倾情打造 ❤️