terminal-controller-mcp

🚀 终端控制器 for MCP

终端控制器 for MCP 是一个模型上下文协议（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