Lazy Terminal

🚀 懒终端

懒终端 是一款智能命令行助手，借助 MCP（模块化组件协议）实现语言模型与外部工具的连接。它可以依据上下文动态判定查询是直接给出回答，还是调用已注册的工具，进而达成无缝的终端自动化与智能交互（您可以偷懒，它可不会）。

🚀 快速开始

📦 安装指南

使用以下命令进行安装：

pip install -r requirements.txt

⚙️ 配置说明

• 编辑 config/models.yaml 文件，添加您的模型凭证。
• 编辑 config/mcp_servers.yaml 文件，列出您的 MCP 服务器。

▶️ 运行步骤

使用以下命令启动助手：

python main.py

之后，您就可以直接从控制台开始与懒终端进行互动啦！

✨ 主要特性

• 动态工具路由：能够自动选择直接回答或进行工具调用。
• 上下文记忆：可维持对话上下文（默认 50 次互动）。
• 多模型支持：通过 Coagent 能够轻松集成各种语言模型。
• 强健的 JSON 处理：可以提取并处理结构化的模型响应。
• 安全的 Bash 执行：通过 MCP 工具安全执行受控的 bash 脚本。

💻 使用示例

基础用法

启动 bash 运行器服务器

python test_servers/bash_runner.py

示例交互

用户输入：

You: 列出 ~/Documents 目录下所有 .txt 文件并将结果保存到 files.txt

助手工具调用：

{
  "tool_name": "run_bash_script",
  "parameters": {
    "commands": "ls ~/Documents/*.txt > files.txt"
  }
}

懒终端会执行此操作并返回结果。

🔑 环境变量

设置模型 API 密钥为环境变量，例如：

export DEEPSEEK_API_KEY="your-api-key"

请确保这些密钥与 models.yaml 中的配置相匹配。

📌 路线图

• [ ] 实现高级记忆压缩。
• [ ] 添加交互式 UI（终端/网页）。
• [ ] 增强错误处理和日志记录。
• [ ] 扩展工具集（例如文件处理、浏览器自动化）。
• [ ] 支持多工具调用

🤝 致谢

• Coagent
• MCP

祝您享受构建智能终端助手的过程！