🚀 懒终端

懒终端 是一款智能命令行助手，借助 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

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