🚀 终端控制器 for MCP

终端控制器 for MCP 是一个模型上下文协议（MCP）服务器，它借助标准接口实现了安全的终端命令执行、目录导航以及文件系统操作，为用户提供便捷高效的终端控制体验。

🚀 快速开始

终端控制器 for MCP 可通过多种方式安装并使用，以下为你详细介绍。

✨ 主要特性

• 命令执行：带超时控制的终端命令运行，全面结果反馈。可运行系统命令，获取实时输出和结果。
• 目录导航：轻松浏览和操作文件系统结构，能浏览目录结构，执行基本的文件管理操作。
• 文件系统操作：对文件和目录进行高效管理，涵盖读取、写入、插入、更新和删除等功能。
• 安全机制：内置黑名单机制，防止危险命令执行。

📦 安装指南

通过 Smithery 安装

# 安装 Terminal Controller for MCP
# 配置 MCP 环境
# 启动服务

使用 Python 包安装

pip install terminal-controller-mcp

📚 详细文档

客户端配置

MCP 客户端配置示例

# 示例配置文件
{
    "server_address": "localhost",
    "port": 5000,
    "timeout": 3600
}

使用说明

命令行使用示例

# 运行终端控制器服务
python -m terminal_controller

# 或者使用 uvx 工具：
uvx terminal_controller

安全注意事项

• 所有命令执行都有超时控制，默认为3600秒。
• 禁止使用危险命令如 rm -rf /、format 和 mkfs。
• 操作结果会被详细记录和审计。

限制与不足

• 命令仅在超时时间内返回结果。
• 默认情况下，服务器拥有与当前用户相同的文件系统权限。
• 部分交互式命令可能无法正常工作，因为它们依赖于交互界面。

故障排除

1. 确保 Python 版本为 3.11 或更高。
2. 检查 MCP 客户端配置是否正确。
3. 直接运行终端控制器检查是否有错误：

   python -m terminal_controller
   

4. 对于 uvx 相关问题，尝试：

   uvx terminal_controller
   

🤝 贡献

欢迎贡献！请随意提交 Pull Request。

📄 许可证

MIT