终端控制器 MCP 服务器

FlowHunt 的终端控制器 MCP 服务器为 AI 代理安全、可编程地访问终端及文件系统操作，提升开发自动化能力。

AI Automation MCP Server Terminal Access File Management

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

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

提示词列表

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

资源列表

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

工具列表

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

典型使用场景

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

部署配置方法

Windsurf

确保已安装 Python 3.11+。
通过 PyPI 安装包：
```
pip install terminal-controller
```

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

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

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

Claude

在本机安装 Python 3.11+。

Claude Desktop 可通过 Smithery 安装：

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

或通过 PyPI 安装：
```
pip install terminal-controller
```

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

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

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

Cursor

确保已安装 Node.js 及 Python 3.11+。
安装 terminal-controller：
```
pip install terminal-controller
```

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

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

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

Cline

确保系统中可用 Python 3.11+。
安装 MCP 服务器：
```
pip install terminal-controller
```

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

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

保存后重启 Cline。
通过 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 资源
工具列表	✅	命令执行、目录管理、文件操作
API 密钥安全配置	✅	配置中可使用环境变量
采样支持（评测时不重要）	⛔	未提及