🐢 懒终端

懒终端 是一个智能命令行助手，通过 MCP（模块化组件协议）将语言模型与外部工具连接起来。它能够根据上下文动态判断查询是直接回答还是调用已注册的工具，从而实现无缝的终端自动化和智能交互（您很懒惰；它不是）。

🔧 功能特性

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

🚀 快速上手

安装

pip install -r requirements.txt

配置

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

运行

使用以下命令启动助手：

python main.py

直接从控制台开始与懒终端互动！

🛠 示例用法

启动 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

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