使用说明
Windows终端MCP服务器
一种模型上下文协议(MCP)服务器,为Windows 11提供终端命令执行功能。
特性
- 通过cmd.exe执行Windows终端命令
- 异步命令执行,具有可配置的超时
- 返回stdout、stderr和退出代码
- Stdio传输,便于与MCP客户端集成
安装
- 创建并激活虚拟环境:
python -m venv venv
venv\Scripts\activate
- 安装依赖项:
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
许可证
麻省理工学院
