终端命令执行服务

一个为Windows 11提供终端命令执行能力的MCP服务器,支持异步执行、超时配置和输出返回。

  • by gabriel-berzescu
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 gabriel-berzescu/mcp-servers

使用说明

Windows终端MCP服务器

一种模型上下文协议(MCP)服务器,为Windows 11提供终端命令执行功能。

特性

  • 通过cmd.exe执行Windows终端命令
  • 异步命令执行,具有可配置的超时
  • 返回stdout、stderr和退出代码
  • Stdio传输,便于与MCP客户端集成

安装

  1. 创建并激活虚拟环境:
python -m venv venv
venv\Scripts\activate
  1. 安装依赖项:
pip install -r requirements.txt

用法

运行服务器

python terminal_server.py

服务器通过stdio运行,可以与任何MCP客户端集成。

可用工具

execute_terminal_command

在Windows终端中执行命令。

参数:

  • command (string,必填):要执行的命令
  • timeout (数字,可选):超时秒数(默认值:30)

退货:

  • 退出码
  • 标准输出(stdout)
  • 标准错误(stderr)

例子:

{
  "command": "dir",
  "timeout": 10
}

配置

要将此服务器与Claude Desktop或其他MCP客户端一起使用,请将其添加到位于以下位置的MCP配置文件中 %APPDATA%\Claude\claude_desktop_config.json:

{
  "mcpServers": {
    "windows-terminal": {
      "command": "c:\\path\\to\\mcp-servers\\venv\\Scripts\\python.exe",
      "args": ["c:\\path\\to\\mcp-servers\\terminal_server.py"]
    }
  }
}

重要提示: 确保在虚拟环境中使用Python可执行文件的完整路径,而不仅仅是 python。这可确保安装在venv中的MCP依赖项可用。

安全

此服务器设计为在沙盒环境中运行。执行任意命令时要小心,因为它们将在运行服务器的用户的权限下运行。

需求

  • Python 3.10+
  • Windows 11
  • MCP Python SDK

许可证

麻省理工学院