终端控制器 MCP 服务器

“终端控制器” MCP 服务器的作用

终端控制器 MCP 服务器是一种模型上下文协议（MCP）服务器，通过标准化接口，实现安全执行终端命令、目录导航和文件系统操作。它作为 AI 助手与主机环境之间的桥梁，让 AI 代理能够以编程方式执行 shell 命令、管理目录及操作文件。凭借内置安全防护、命令历史追踪和跨平台兼容性，终端控制器为开发流程赋能，使 AI 工具能受控访问主机终端与文件系统。此能力让 AI 助手能够安全、标准化地自动化、探索及管理开发者的系统级任务。

提示词列表

仓库或文档中未找到任何提示词模板。

资源列表

仓库或文档中未明确定义任何 MCP 资源。

工具列表

• 命令执行：可运行终端命令，支持超时控制，并捕获全面输出。
• 目录管理：支持目录内容导航及列表，格式直观。
• 文件操作：支持读取、写入、更新、插入和删除文件内容，精确到行级。
• 命令历史：追踪并展示最近命令执行记录，便于审计与复现。

典型使用场景

• 自动化命令执行：开发者可让 AI 助手安全地运行 shell 命令用于构建、测试或部署代码，并捕获输出与错误。
• 目录与文件管理：AI 代理可协助整理、浏览或操作文件与文件夹，便于自动化代码库探索或环境搭建。
• 安全脚本编排：内置防护机制，可防止危险命令，降低向 AI 开放终端的风险。
• 系统监控与审计：命令历史功能可追踪执行动作，便于审计和工作流透明化。
• 跨平台开发：支持 Windows 及类 UNIX 系统，便于在多样环境下获得一致的开发体验。

部署配置方法

Windsurf

1. 确保已安装 Python 3.11+。
2. 通过 PyPI 安装包：

   pip install terminal-controller
   

3. 编辑 Windsurf 配置文件，添加 MCP 服务器：

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. 保存配置并重启 Windsurf。
5. 验证 MCP 服务器是否已运行并可访问。

Claude

1. 在本机安装 Python 3.11+。
2. Claude Desktop 可通过 Smithery 安装：

   npx -y @smithery/cli install @GongRzhe/terminal-controller-mcp --client claude
   

3. 或通过 PyPI 安装：

   pip install terminal-controller
   

4. 在 Claude 配置中加入以下内容：

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

5. 重启 Claude Desktop，并确认已检测到 MCP 服务器。

Cursor

1. 确保已安装 Node.js 及 Python 3.11+。
2. 安装 terminal-controller：

   pip install terminal-controller
   

3. 在 Cursor 配置中添加 MCP 服务器：

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. 保存文件并重启 Cursor。
5. 在 Cursor 工具列表中确认集成成功。

Cline

1. 确保系统中可用 Python 3.11+。
2. 安装 MCP 服务器：

   pip install terminal-controller
   

3. 在 Cline 配置文件中添加如下片段：

   {
     "mcpServers": {
       "terminal-controller": {
         "command": "python",
         "args": ["-m", "terminal_controller"]
       }
     }
   }
   

4. 保存后重启 Cline。
5. 通过 MCP 接口运行简单命令测试。

API 密钥安全配置

如需配置 API 密钥或其他敏感信息，建议使用环境变量而非硬编码。示例配置如下：

{
  "mcpServers": {
    "terminal-controller": {
      "command": "python",
      "args": ["-m", "terminal_controller"],
      "env": {
        "MY_API_KEY": "${MY_API_KEY_ENV_VAR}"
      },
      "inputs": {
        "api_key": "${MY_API_KEY_ENV_VAR}"
      }
    }
  }
}

在流程中集成 MCP 的方法

在 FlowHunt 中使用 MCP

将 MCP 服务器集成到 FlowHunt 工作流时，首先将 MCP 组件添加到流程，并与 AI 代理连接：

点击 MCP 组件以打开配置面板。在系统 MCP 配置部分，按如下 JSON 格式填写你的 MCP 服务器信息：

{
  "terminal-controller": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置后，AI 代理即可作为工具使用此 MCP，访问其所有功能与能力。请记得将 “terminal-controller” 替换为你的 MCP 服务器真实名称，并更换 URL 为你的 MCP 服务器地址。

概览

综上，终端控制器 MCP 以安全方式提供了必要的终端与文件系统访问，但暂无提示词模板与显式资源。其配置文档详实且跨平台。未涉及 roots 或采样。总体而言，这是一个实用、安全但相对简洁的核心 DevOps 或自动化服务器。

MCP 评分