winterm-mcp

# winterm-mcp **更新日期**: 2026-02-05 **版本**: 0.1.8 Windows Terminal MCP Service - 专门支持 Windows 终端的异步命令执行工具。 ## 功能特性 - **PowerShell 支持**: 直接执行 PowerShell 命令（默认） - **Cmd 支持**: 可选执行 cmd 命令 - **异步执行**: 后台执行命令，立即返回 token - **状态查询**: 查询命令执行状态和结果 - **超时控制**: 可设置超时时间（1-3600秒） - **工作目录**: 指定执行目录 - **自动编码**: 自动处理 PowerShell (UTF-8) 和 Cmd (GBK) 编码 ## 安装 ```bash cd winterm_mcp_standalone pip install -e . ``` ## 使用方法 ### MCP 配置 在 MCP 客户端配置中添加： **基础配置**: ```json { "mcpServers": { "winterm": { "command": "uvx", "args": [ "winterm-mcp" ] } } } ``` **推荐配置（带环境变量）**: ```json { "mcpServers": { "winterm": { "command": "uvx", "args": [ "winterm-mcp" ], "env": { "WINTERM_POWERSHELL_PATH": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe", "WINTERM_CMD_PATH": "C:\\Windows\\System32\\cmd.exe", "WINTERM_PYTHON_PATH": "C:\\Python310\\python.exe", "WINTERM_LOG_LEVEL": "DEBUG" } } } } ``` ### 环境配置 #### PowerShell 路径配置 在某些受限环境（如沙箱环境）中，系统 PATH 可能不包含 PowerShell 路径。winterm-mcp 会自动探测以下位置： 1. `C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe` 2. `C:\Windows\SysWOW64\WindowsPowerShell\v1.0\powershell.exe` 3. `C:\Program Files\PowerShell\7\pwsh.exe`（PowerShell Core） 4. `C:\Program Files (x86)\PowerShell\7\pwsh.exe` 如果 PowerShell 安装在非标准位置，可通过环境变量指定： **方式一：系统环境变量** ```bash # Windows CMD set WINTERM_POWERSHELL_PATH=D:\CustomPath\powershell.exe # Windows PowerShell $env:WINTERM_POWERSHELL_PATH = "D:\CustomPath\powershell.exe" ``` **方式二：MCP 配置** ```json { "mcpServers": { "winterm": { "command": "uvx", "args": ["winterm-mcp"], "env": { "WINTERM_POWERSHELL_PATH": "C:\\Windows\\System32\\WindowsPowerShell\\v1.0\\powershell.exe" } } } } ``` #### Python 路径配置 如果需要指定命令执行时使用的 Python 解释器，可以通过 `WINTERM_P…